home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
UTILITY
/
TOOLBOX.ARJ
/
TOOLBOX.EXE
/
TOOLBOX.DOC
< prev
next >
Wrap
Text File
|
1991-04-24
|
207KB
|
4,859 lines
===================================================================
<*> Computer Tyme DOS ToolBox <*>
Reference Manual
Copyright 1983 - 1991 by Marc Perkel
All Rights Reserved * Version 2.0 * Release Date: 04-18-91
Computer Tyme * 411 North Sherman Suite 300 * Springfield Mo. 65802
(417) 866-1222 voice * (417) 866-1665 bbs
Fax: (417) 866-0135
CompuServe 76505,1120
===================================================================
Computer Tyme DOS ToolBox * Table of Contents Page 1
_______________________________________________________________
License ........................................... 1
Warranty .......................................... 1
Trademarks ........................................ 2
Disclaimer ........................................ 2
Acknowledgements .................................. 2
Introducing the DOS ToolBox ....................... 3
DM Poem ........................................... 3
Backing up your Program Disks ..................... 4
Changing the Prompt ............................... 4
Installing the DOS ToolBox ........................ 4
The Path Command .................................. 5
Directory Master .................................. 5
-- DM's WorkHorse Functions ....................... 6
-- Software Philosophy Behind DM .................. 7
-- Main Screen .................................... 8
-- Help Screen .................................... 10
-- Marking and UnMarking Files .................... 10
-- Single File Commands ........................... 11
-- Marked File Commands ........................... 11
-- General Commands ............................... 12
-- Disk Statistics ................................ 12
-- Extra Functions ................................ 12
-- Exiting DM ..................................... 13
-- Function Key Commands .......................... 13
-- Marking Files .................................. 15
-- Copy a File .................................... 15
-- Copy All Marked Files .......................... 16
-- Move a File .................................... 16
-- Move all Marked Files .......................... 16
-- Delete a File .................................. 17
-- Delete all Marked Files ........................ 17
-- Controlling the Sort Order ..................... 17
-- Renaming Files ................................. 17
-- Viewing Text Files ............................. 18
-- Editing Text Files ............................. 18
-- Patching a File ................................ 18
-- Change File Date ............................... 19
-- The Status Window .............................. 19
-- Disk Free Space ................................ 19
-- Goto Filename .................................. 20
-- Re-Reading the Directory ....................... 20
-- Changing Disk Drives ........................... 20
-- Changing the Path .............................. 20
-- Changing the File Mask ......................... 21
-- Tree Mode ...................................... 21
-- Wildcard Mark .................................. 22
-- Reverse Marks .................................. 22
-- Changing Colors ................................ 23
-- Execute a DOS Command .......................... 23
-- Execute a File ................................. 23
-- Programmable Function Keys ..................... 24
Computer Tyme DOS ToolBox * Table of Contents Page 2
_______________________________________________________________
-- Programming with Variables ..................... 26
-- Saving your Programming ........................ 28
-- The AutoRun Key ................................ 29
-- About File Attributes .......................... 31
-- Changing File Attributes ....................... 32
For New Users ..................................... 33
Technical Support BBS ............................. 39
PD.EXE - Pick Directory ........................... 39
DoList ............................................ 43
-- DoList Shell Mode .............................. 43
-- Internal Dolist Commands ....................... 45
-- DoList in LIST Mode ............................ 46
D.EXE - Sweet Little Directory Program ............ 48
FIND.EXE .......................................... 50
SORT.EXE .......................................... 50
MORE.EXE .......................................... 50
FREE.EXE - Disk Free Space Utility ................ 51
FIXPATH.EXE ....................................... 51
FORK.EXE .......................................... 51
PIPEDIR.EXE ....................................... 52
WHEREIS.EXE ....................................... 52
MOVE.EXE .......................................... 53
ZDEL.EXE - Delete Utility ......................... 54
RAMMAP.EXE - Memory Display Utility ............... 54
INMEM.EXE ......................................... 55
KBD.EXE - Keyboard Utility ........................ 55
PARK.COM - Parks your Hard Disk Heads ............. 57
BATEXIT.BAT - Worlds Smallest Useful Program ...... 57
TESTIF.EXE - Batch File Utility ................... 58
VERSION.EXE ....................................... 61
TEDIT.EXE - Full Screen Text Editor ............... 61
-- Status Line .................................... 62
-- Main Pull Down Menu ............................ 62
-- Quick Keys ..................................... 62
-- File ........................................... 62
-- Block .......................................... 63
-- Search ......................................... 63
-- Print .......................................... 64
-- Editing ........................................ 64
-- Other .......................................... 64
-- Quit ........................................... 64
-- Saving your work ............................... 65
TSR Management Utilities .......................... 65
-- About TurboPower Software ...................... 65
-- Introduction ................................... 66
-- Mark, FMark, and Release ....................... 67
-- MarkNet and RelNet ............................. 72
-- Watch and Disable .............................. 75
-- MapMem, RamFree, and Device .................... 76
-- EatMem ......................................... 81
The Network Survival Kit .......................... 81
XMETER.EXE - Software Metering .................... 81
Computer Tyme DOS ToolBox * Table of Contents Page 3
_______________________________________________________________
LOGOFF.EXE ........................................ 84
BESTNET.EXE ....................................... 84
NS.EXE - NetSmart ................................. 86
Other Computer Tyme Products ...................... 87
Computer Tyme DOS ToolBox Users Manual Page 1
_______________________________________________________________
LICENSE AGREEMENT LICENSE AGREEMENT LICENSE AGREEMENT
Computer Tyme DOS ToolBox - Copyright 1983-1991 - All rights Reserved.
You are licensed to use this program on a single CPU or workstation. If
you are running on a network, you are required to license a separate
copy for each workstation or a file server license for each file server.
If you are running on a multiuser operating system such as Concurrent
DOS, you are required to license a copy for each workstation. Everyone
who uses this menu, must license a copy unless several people share the
same workstation.
This software is licensed and not sold. The license begins when Computer
Tyme receives payment in full. You may not transfer, sell, sublease or
rent this software without the written consent of Computer Tyme. You are
not allowed to distribute MarxMenu in runtime form with software you
developed unless it is in combination with a paid for copy of MarxMenu,
or you have made special arrangements in writing with Computer Tyme to
do so.
Use of this product constitutes your acceptance of the terms and
conditions of this license and of my copyright and your agreement to
abide by these terms and conditions.
WARRANTY WARRANTY WARRANTY
The warranty is limited to the diskettes to be machine readable for a
period of 30 days after purchase. Although we try hard to write perfect
software that has no bugs, we do not guarantee that. We also do not
guarantee that this product is fit for every purpose and we are not
liable for any damages that might occur from use of this product. This
agreement is governed by the laws of the State of Missouri.
Computer Tyme
411 North Sherman, Suite 300
Springfield, Mo. 65802
417-866-1222 voice * 417-866-1665 bbs * 417-866-0135 fax
Computer Tyme DOS ToolBox Users Manual Page 2
_______________________________________________________________
TRADEMARKS TRADEMARKS TRADEMARKS
MarxMenu, DOS ToolBox, Directory Master, and The Network Survival Kit
are trademarks of Computer Tyme.
QEdit and TEdit are trademarks of SemWare.
Lotus is a registered trademark of Lotus Development.
Wordstar is a registered trademark of MicroPro International.
Smart Software is a trademark of Informix.
MS-DOS is a trademark of Microsoft.
Turbo Pascal is a trademark of Borland International.
OPRO and TPRO are trademarks of TurboPower Software
Netware and Novell are trademarks of Novell
DesqView and QEMM are trademarks of Quarterdeck
IBM is a trademark of International Business Machines
DISCLAIMER DISCLAIMER DISCLAIMER
Use of this program acknowledges this disclaimer of warranty: "This
program is supplied as is. Computer Tyme disclaims all warranties,
expressed or implied, including, without limitation, the warranties
merchanticability and of fitness of this program for any purpose.
Computer Tyme assumes no liability or damages direct or consequential,
which may result from the use of this program."
ACKNOWLEDGEMENTS ACKNOWLEDGEMENTS ACKNOWLEDGEMENTS
I'd like to thank the following people for making this software
possible.
Vicki Perkel, for staying up late hours working on this manual, writing
the DM poem, and being good to me.
The staff at Computer Tyme for their effort and support and being the
best employees in the world.
Borland International for writing Turbo Pascal and keeping it bug free
and well supported.
TurboPower Software for their very powerful extensions to Turbo Pascal,
and their well written, well supported product.
SemWare for their TEdit and QEdit full screen editors.
All you users who actually paid for this package so that we may continue
to eat. And those of you who have made suggestions to improve our
product.
Computer Tyme DOS ToolBox Users Manual Page 3
_______________________________________________________________
INTRODUCING THE DOS TOOLBOX INTRODUCING THE DOS TOOLBOX INTRODUCING THE DOS TOOLBOX
The Computer Tyme DOS ToolBox contains powerful and simple to use
utilities. Some of the programs are written for beginners, others for
intermediate and advanced users. The Computer Tyme DOS ToolBox programs
come with help screens and on-line documentation which give quick
proficiency with each program. The following information briefly
explains what each program does and the user level it is best suited
for. More complete information on each program is subsequently provided
in this reference manual.
Computer Tyme invites you to begin using these programs now. Once you
begin using Directory Master, DoList, etc., you will not want to be on a
computer that doesn't have them. We are continuing to develop and
improve the Computer Tyme DOS ToolBox. Our goal is to continue to
develop programs that make DOS easier for the novice and more powerful
for the professional. Your comments and suggestions are always welcome.
DM, just a programmer's whim?
More than a whim, is new DM
Selects, reflects and sorts for you
Tags, then nags for more to do.
Pick your drive, name your path
Up comes your file in nothing flat!
To quickly review or execute files
Programmable keys will make you smile.
Need files copied, moved or deleted?
These routine tasks are quickly completed
So hack or sack whatever your whim
Have yourself a blast with new DM!
By: Vicki Perkel
Computer Tyme DOS ToolBox Users Manual Page 4
_______________________________________________________________
BACKING UP YOUR PROGRAM DISKS BACKING UP YOUR PROGRAM DISKS BACKING UP YOUR PROGRAM DISKS
You should always make a backup of each of your software disks. The
backup, or working copy, is for everyday use. Put the original in a safe
place. Then, if something happens to the working copy you can make
another copy from the original.
1) Have your "DOS ToolBox" diskette and a blank diskette ready.
2) Bring up the "C>" prompt and type "DISKCOPY A: A:" and then press the
Enter key. This tells the computer to copy the disk in drive A to
another disk which will later be put in drive A.
3) Follow the instructions on the screen. The "CT DOS ToolBox" diskette
is the "source" and the blank diskette is the "target."
Note: Your blank disk does not need to be formatted in advance. The
"DISKCOPY" command formats the disk at the same time that the files are
being copied.
CHANGING THE PROMPT CHANGING THE PROMPT CHANGING THE PROMPT
Some computers do not display the name of the current subdirectory at
the prompt. You may see only the prompt, for example, C> or C:. By
typing PROMPT $P: at the DOS command line you will be able to see the
name of the current directory at the prompt when you change directories.
INSTALLING THE DOS TOOLBOX INSTALLING THE DOS TOOLBOX INSTALLING THE DOS TOOLBOX
The Computer Tyme DOS ToolBox may be used on any PC/XT/AT compatible
system with a hard disk and at least 384k resident memory.
Turn on the system. When "C:" appears, insert the program disk in Drive
A. At this point you can either create a new directory for the files or
copy them into an existing directory. Whatever you choose, the files
need to be in a directory which is "path accessable" (see "The Path
Command.")
To make a directory, type MD space and the name of the new directory.
Then type CD space and the name of the new directory. To put the files
in an existing directory, just type CD space and the name of the
directory. At this point you are ready to copy the files from the floppy
to the hard drive. Next type copy a:*.* and press the Enter key. After
the programs are copied, type INSTALL. This will unpack all the ToolBox
Programs.
Computer Tyme DOS ToolBox Users Manual Page 5
_______________________________________________________________
THE PATH COMMAND THE PATH COMMAND THE PATH COMMAND
It is to your advantage to be able to execute the programs from any
subdirectory you may be in. To do this, you may have to designate a path
in your autoexec.bat file using the DOS "Path" command. When using a
hard drive, you may frequently be in a directory other than the one
the programs are in.
The "Path" command allows you to execute a program when it is not in the
subdirectory you are currently in. If you want to execute the programs
from any directory, put them in a directory that your PATH is set up to
access. If you have not set up a path command, refer to your MS-DOS
manual or your friendly neighborhood computer wizard as to how to do
this.
DIRECTORY MASTER DIRECTORY MASTER DIRECTORY MASTER
To execute Directory Master, type "DM". Directory Master "DM", is a
powerful utility program for MS-DOS compatible computers. DM was created
to allow you to copy, move and delete files quickly and easily. But we
didn't stop there. Special features allow you to run programs, execute
commands, and view files directly from DM, then return to DM exactly
where you left off.
DM is streamlined - many tasks can be completed with just one keystroke.
DM allows you to maintain order on your disks with a minimum of time and
effort. When you use DM, you are able to skim through your directory and
mark all the files you want to be moved, copied, or deleted. If you have
lots of files to delete, you can delete them all at once. If you want to
copy selected files onto a diskette, you can copy them all at once.
The Tree Mode allows you to jump from the root directory to any
subdirectory and back again with a minimum of keystrokes. Suppose you
want to separate your data files from your spreadsheet program files.
You can mark all data files, create a subdirectory to hold them and move
them all at once.
Perhaps you have a lot of old document files in your word processor
program and you want to delete the clutter, but you can't remember
what's in a certain file. No problem, the Programmable Function Keys
allow you to call up the word processor and load the indicated file in
one keystroke. After you've looked over the file and exited the word
processor, you automatically return to DM, right where you left off.
Computer Tyme DOS ToolBox Users Manual Page 6
_______________________________________________________________
DM'S WORKHORSE FUNCTIONS DM'S WORKHORSE FUNCTIONS DM'S WORKHORSE FUNCTIONS
Quick backups - copy all or selected files from one diskette to another,
or from the hard drive to diskette or vice versa.
Maintain order - categorize your files in subdirectories. DM quickly
moves your files from one subdirectory to another or from the root
directory to subdirectories.
Easy disk cleanup - move or delete selected files from any drive.
Scan quickly through a hard disk's root directory and subdirectories.
Check any drive to see the size of individual files and the amount of
free space on the disk.
Sort files in a directory for viewing in any order desired:
alphabetical by filename, alphabetical by extension, by date, by size,
or reverse the sorted order.
List only certain files within a directory, such as those with a given
extension.
Execute a program or view the contents of a file directly from DM, and
return to DM exactly where you left off.
Rename any file. Change the date on any file.
Change the attributes of a file, including: Hidden, System, Read-Only,
and Archive.
Execute a DOS command directly from DM and return to DM in the same
place that you left off.
Custom program up to 30 function keys. Get to know DM's Special AutoRun
Feature.
Computer Tyme DOS ToolBox Users Manual Page 7
_______________________________________________________________
SOFTWARE PHILOSOPHY BEHIND DM SOFTWARE PHILOSOPHY BEHIND DM SOFTWARE PHILOSOPHY BEHIND DM
DM was originally written in 1985 to provide the same functions for
MS-DOS as a program called SWEEP did for CP/M. The main function of this
program is to be able to select files from a list of files, then either
copy them, move them, or delete them. Thus the design of this program is
such to make these functions as easy as possible.
In order to help you decide which files to copy, move, or delete, DM
allows you to sort the list by name, date, extension or size, and to
reverse the sorted order. This allows you to list files in a directory
several different ways. In addition, DM allows you to use a file mask,
to work with a group of files rather than the whole directory.
The files are displayed in a vertical list. The up and down arrows, page
up, page down, home and end keys move you through the list. The "G"
(GOTO) command is provided to help you get to a desired place in the
list quickly. Files are selected (marked) using the right arrow key, and
unselected (unmarked) using the left arrow key. All files can be marked
using Ctrl-Right Arrow and unmarked using the Ctrl-Left Arrow. A wild
card mark is provided to mark all files that match a particular mask.
When files are marked they are simultaneously highlighted for action.
Once files are marked (highlighted) they can be copied, moved to another
disk drive or subdirectory, or deleted. You can change file attributes
on all marked files or run a program on all marked files. Copy, move,
delete, and change file attributes can be performed on the file at the
pointer. You can rename the file or change the file's date. You can
execute the file or run up to 30 predefined programs on a file.
To help you move through the directory structure, the Tree Mode is
provided which shows you only directories. By using the arrow keys, you
can move back and forth between them.
DM provides a status window that allows you to see the number of files,
the total size of all files, the number of marked files, and the total
size of all marked files. It shows the free space on the disk and
provides additional information about the file that you are pointing to.
Current path, drive, and file mask information are also displayed.
DM allows you to execute programs or DOS commands on the file you are
pointing to or on all marked files. The Autorun feature has the ability
to figure out what program to run on a file by recognizing the name of
the file's extension. This would be used if, for example, you are in
your spreadsheet directory trying to determine which spreadsheets to
delete. In the process you would like to look at them before marking
them for deletion. By programming an AutoRun string to load your
spreadsheet program and bring up the file at the pointer, DM will let
you execute your spreadsheet program and load the file you are pointing
to, then return to DM exactly where you left off.
Computer Tyme DOS ToolBox Users Manual Page 8
_______________________________________________________________
DM is designed to be as intuitive as possible. If you get confused,
press F1 for help. The following one-letter commands work on the file at
the pointer. C is for Copy, D for Delete, M is for Move, and A is for
Attributes. The following commands have the same functions as described
above but work on all marked files: Alt-C for Copy, Alt-D for Delete,
Alt-M for Move and Alt-A for Attributes. (Remember to type the letter
while simultaneously holding down the Alternate Key.) Other commands
include R to Rename a file, T for Change Date, F for Freespace, V for
View, E for Edit, P is for Patch, G for Goto, S for Sort, and Q to Quit.
Many of the functions of DM are especially helpful to the advanced
computer user. If you don't understand all the functions of DM, just
stick to the simple ones. As your knowledge of MS-DOS and computers
grow, you will find more and more uses for DM.
MAIN SCREEN MAIN SCREEN MAIN SCREEN
+-------------------------------------------------------------------+
| File Name Date Size | Total * Marked |
|>FCPY.BAT 05-20-87 2k | Size of Files: 3716 | 0 Free: 1738k |
| FLESYS.EXE 11-30-88 12k | Numb of Files: 236 | 0 Sort: Name |
| FIND.EXE 12-21-90 8k | Subs: 20 |
| FIXPTH.EXE 12-21-90 6k | Path: C:\ |
| FMARK.COM 01-27-90 2k | Size: 26 Mask: *.* |
| FORK.EXE 12-21-90 6k | Attributes: Archive |
| FORMAT.COM 12-13-90 32k |-----------------------------------------|
| GOFILE.BAT 09-29-90 2k | |
| HANDW 09-26-90 2k | |
| HIMEM.SYS 12-13-90 12k | |
| HIRES.COM 07-23-87 2k | |
| HYPE.TXT 12-17-87 6k | +----------+ |
| ICE.MNU 03-11-90 2k | | F1 Help | |
| INMEM.EXE 12-21-90 6k | +----------+ |
| INMEM.TXT 11-28-90 2k | |
| INST.MNU 12-30-90 18k | |
| INSTAL.TXT 04-13-89 4k | |
| IO.SYS 02-07-91 34k*| <*> Directory Master <*> |
| IPXRX.COM 03-02-91 30k | Computer Tyme |
| JIVE.DOC 09-23-87 2k | 411 North Sherman Suite 300 |
| JIVE.EXE 10-11-86 36k | Springfield, Mo. 65802 (417) 866-1222 |
+-------------------------------------------------------------------+
This is the DM Main Menu Screen. The following is a brief description of
each feature on the screen, followed by a text reference.
FILE WINDOW (Left Window):
FILE NAME - The column of names under this heading lists the files in
the current directory.
Computer Tyme DOS ToolBox Users Manual Page 9
_______________________________________________________________
DATE - This shows the date the file was created or last modified.
SIZE - This tells how many bytes are in the file, in k (1024 bytes).
STATUS WINDOW (Upper Right Window):
SIZE OF FILES - Under the heading marked "Total" is the total disk space
used by files in the current directory. Under the heading entitled
"Marked" is the total of all marked files.
NUMBER OF FILES - Under the heading marked "Total" is the number of
files on the current disk or subdirectory. Under the heading entitled
"Marked" is the number of all marked files.
FREE - The amount of free space on the current disk, in "k", is shown
here.
SORT - Displays how the directory is sorted. If "Name" appears files in
the directory are displayed in alphabetical filename order. If Name R
appears, the files are sorted in reverse filename order.
SUBS - This is the number of subdirectories off the current directory.
If you enter the Tree Mode, the number of files in the current
subdirectory is displayed.
PATH - This shows the drive and pathname of the current directory. A
letter and backslash, C:\ for example indicates the root directory. A
name after the backslash indicates the current drive and subdirectory
(Example: Path: C:\WS).
SIZE - This is the actual number of bytes in the file next to the
pointer.
ATTRIBUTES - If the file at the pointer has special attributes, they
will be shown here.
MASK - The Mask shown here indicates that all or a selected portion of
the directory is listed. If *.* appears as the mask, the entire
directory will be shown. If for example, *.doc is shown, all .doc
(document) files will be listed.
Computer Tyme DOS ToolBox Users Manual Page 10
_______________________________________________________________
HELP SCREEN HELP SCREEN HELP SCREEN
+------------------------------------------------------------------+
| |
| -> Mark File CTRL -> Mark All Files Tab FKey Help |
| <- Clear File CTRL <- Clear All Files F1 More Help |
| F2 AutoRun |
| C Copy File D Delete File F3 AutoRun + Text |
| M Move File A Change Attribute F4 Dos Command |
| R Rename File T Change Date F5 Change Disk |
| L Re-Read Directory W Wildcard Mark F6 Change Path |
| S Sort Order G Goto FileName F7 Subdirectories |
| F FreeSpace X Extra Functions F8 Edit Commands |
| V View File E Edit File F9 Register DM |
| P Patch File \ Jump to Root Dir F10 Marked Menu |
| Q Quit DM Esc Abort Command |
| |
| |
| For All Marked Files Press TAB key for FKey Definitions |
| |
| Alt-C Copy Files Programmable Alt-F1 .. Alt-F10 |
| Alt-M Move Files Function Ctrl-F1 .. Ctrl-F10 |
| Alt-D Delete Files Keys Shift-F1 .. Shift-F10 |
| Alt-A Change Attributes |
| |
+------------------------------------------------------------------+
F1 HELP - Displays Help Screen No. 1. Press Esc to exit help. To display
Help Screens 2 and 3, continue to press F1. See lower right hand screen
of DM Main Menu for F1 reminder.
MARKING AND UNMARKING FILES MARKING AND UNMARKING FILES MARKING AND UNMARKING FILES
The following right and left cursor keypad arrows are used to mark and
unmark files:
-> Marks File CTRL -> Marks All Files
<- Unmarks File CTRL <- Unmarks All Files
The following is a list of DM Commands. These commands are not listed as
they appear on the above screen but rather in the order of most frequent
usage.
Computer Tyme DOS ToolBox Users Manual Page 11
_______________________________________________________________
SINGLE FILE COMMANDS SINGLE FILE COMMANDS SINGLE FILE COMMANDS
C - Copy File - Copies only the file at the pointer to a new name (in the
same directory) or to another disk and subdirectory.
D - Delete File - Deletes only the file at the pointer.
M - Move File - Moves only the file at the pointer.
G - Goto FileName - User may search directory for a specific file by
typing the filename. Will search on partial name match.
V - View File - Displays the contents of the file at the pointer, in
ASCII text.
E - Edit File - DM is set up to run the program TEDIT which is included
in the package, however you may setup DM to run your favorite editor to
modify any text or document file.
R - Rename File - User may type in a new filename.
T - Change Date - User may type in a new date for files or press F2 for
today's date.
A - Change Attributes - Changes attributes of the file at the pointer.
P - Patch File - Setup DM to run your favorite "patch" program to modify
a file. Warning: This program is for advanced users only.
MARKED FILE COMMANDS MARKED FILE COMMANDS MARKED FILE COMMANDS
Alt-C - Copy Files - Copies marked (highlighted) files to the specified
path.
Alt-M - Move Files - Moves all marked files to the specified path.
Alt-D - Delete Files - Deletes all marked files.
Alt-A - Change Attributes - Changes the attributes of all marked files.
Computer Tyme DOS ToolBox Users Manual Page 12
_______________________________________________________________
GENERAL COMMANDS GENERAL COMMANDS GENERAL COMMANDS
L - Re-read Directory - Reads the current disk. Useful for quickly
reading a new disk when inserted in the floppy drive, or re-listing the
current directory of the hard disk after adding new files.
S - Change Sort Order - Changes the order in which the directory is
sorted.
W - Wildcard Mark - User selects and simultaneously marks several files
at once by using wildcards.
DISK STATISTICS DISK STATISTICS DISK STATISTICS
F - FreeSpace - Gives statistics for any drive specified.
EXTRA FUNCTIONS EXTRA FUNCTIONS EXTRA FUNCTIONS
Type "X" to display the following menu, then type the desired letter to
perform its task. These are not to be confused with F1-F10 Function
Keys.
R - Reverse all Marks - Reverses highlighting of marked files.
\ - Root Directory - Move to the root directory of current drive.
T - Root Directory Tree Mode - Quickly display all subdirectories off
the root directory.
C - Set Colors - (See "Changing Colors on the Screen.")
V - Set VIEW Program - Set up DM to run your favorite view program. The
default setup is the DOS "View" program.
E - Set EDIT Program - TEdit is set up as the default edit program. Type
"E" to set up DM to run your favorite editor program. Type CTRL KD to
save and then quit and CTRL KQ to quit without saving. Use caution in
editing files. Do not edit a file which is not a text file; to do so
could result in program or system difficulties.
P - Set PATCH Program - Set up DM to run your favorite patch program.
S - Save Configuration - Save changes made to the screen colors or the
Function Key setups.
Computer Tyme DOS ToolBox Users Manual Page 13
_______________________________________________________________
EXITING DM EXITING DM EXITING DM
ESC - Press ESC (Escape) once to abort commands, twice to exit DM.
Q - Quit DM - Press "Q" to exit the DM program.
ALT-X - Quits immediately.
FUNCTION KEY COMMANDS FUNCTION KEY COMMANDS FUNCTION KEY COMMANDS
The Function Keys are the F1-F10 keys which appear on every keyboard.
The DM Function Keys perform a variety of functions. Refer to Help
Screen No. 1 for a list of Function Keys and what they do.
F1 - Help Screen No. 1 - Press F1 once to display Help on DM commands,
marking files, Function Keys and Programmable Function Keys settings.
F1 - Help Screen No. 2 - Press F1 twice to read about "What is DM?," the
"Special Function Keys and Autorun". There are 30 programmable key
combinations available which are user defined; Alternate Functions Keys
(Alt F1-F10), Control Function Keys (Ctrl F1-F10) and Shift Function
Keys (Shft F1-F10).
Press the Tab key to view the Programmable Function Key default
settings. You may reprogram these keys and write the help text yourself.
(See "The Programmable Function Keys."). The Autorun Key is F2. To
reprogram the (F2) Autorun Key press F8. (See "The Autorun Key.")
F1 - Help Screen No. 3 - Press F1 three times for DM Copyright, purchase
order information and phone numbers.
F2 - AutoRun - As discussed in the above paragraph, this key may be
programmed by the user by pressing F8 and selecting option 4. Set up
AutoRun to execute a program or a DOS command on the file at the
pointer. For more information (See "The AutoRun Key.")
F3 - Execute File - Executes the file at the pointer if the file is
executable (has extension .EXE, .COM, or .BAT). (See "Execute a
File.")
F4 - DOS Command - Executes a DOS command. (See "Execute a DOS Command.")
F5 - Change Disk - Quickly move from one drive to another by typing the
drive letter. (See "Changing Disk Drives.")
F6 - Change Path - Move to another drive, path by typing new path name
or select files by using a particular mask with embedded wildcards. (See
"Path and Changing the Mask.")
Computer Tyme DOS ToolBox Users Manual Page 14
_______________________________________________________________
F7 - Tree Mode - Allows scanning of subdirectories. Under tree mode a
new set of commands are available:
F7 - Return back to file mode.
R - Rename subdirectory
-> - Jump to subdirectory - move to the subdirectory at pointer
<- - Jump to subdirectory toward Root
RET - Jump to SubDir and Exit Tree Mode - list files in the subdirectory
indicated by the pointer and exit Tree Mode
\ - Jump to Root Directory - (See "About Directories and
Subdirectories" and "Tree Mode")
F8 - Edit Commands - Used to custom program the Alternate Function Keys,
Control Function Keys, Shift Function Keys and the AutoRun (F2) Key.
(See "The Programmable Function Keys," and "The AutoRun Key".)
F9 - Print Order Form - Used to print The Computer Tyme DOS ToolBox
purchase order form.
F10 Marked Menu - This is an alternate method of copying, moving,
deleting, changing the attributes and executing DOS commands on marked
(highlighted) files. Use your creativity here.
C Copy - Copy marked files.
M Move - Move marked files.
D Delete - Delete marked files.
A Change Attributes - Change attributes of marked files Ctrl, Alt &
Shift Function Keys or F4 to Batch execute marked files.
Computer Tyme DOS ToolBox Users Manual Page 15
_______________________________________________________________
MARKING FILES MARKING FILES MARKING FILES
If you want to copy, move or delete several files at once, you must
"mark" the files first. This tells the computer which files you want to
copy, move or delete.
To mark a file, position the pointer next to that file and press the
right arrow -> key. The name of the file will be highlighted to indicate
that it has been "marked." Press the left arrow <- key to un-mark a
file. You may mark as many files as you wish. Ctrl -> marks all files in
the current directory, and Ctrl <- un-marks all files.
Caution: If you want to copy, move or delete a single file do not mark
the file, just position the pointer in front of the filename and type
the desired command. Reason: If you mark a single file the pointer will
move down to the next filename. If you then type a command for a single
file such as "C", it will copy the file below the one highlighted.
COPY A FILE COPY A FILE COPY A FILE
If you want to copy a file, use the up arrow and down arrow keys to
position the pointer next to the file to be copied. Then press the C
key. The message "Press down arrow to copy filename to another filename.
To Path:" will appear. Pressing down arrow allows you to copy the file
to the same or another filename within the same subdirectory. Typing in
the pathname at the above message copies the file to a new subdirectory
(path). Type the name of the drive and subdirectory that the file is to
be copied to, then press the Enter key. The file will be copied.
(New Users: See "Changing the Path.")
If you are copying from a disk in Drive A to the hard disk, then type
"C:" Enter, and the subdirectory name when "To Path:" appears. If you
are copying from the hard disk to a disk in Drive A, then type "A:"
Enter, when "To Path" appears. You must have a formatted disk in drive
A. When you specify only the drive name such as C:, the file will be
copied to the "current directory" on that drive.
Computer Tyme DOS ToolBox Users Manual Page 16
_______________________________________________________________
COPY ALL MARKED FILES COPY ALL MARKED FILES COPY ALL MARKED FILES
Mark all files that you want to copy, then press the Alt C keys
simultaneously. The message "Copy Marked Files. To Path:" will appear.
Type the name of the path to which the files should be copied. Press the
Enter key. All marked files will be copied to the specified path. The
following conventions should be used to type the path. (See "Changing
the Path").
A: = Drive A (usually floppy drive)
C: = Drive C (hard drive)
C:\ = Drive C (root directory of hard drive)
C:\NAME = Subdirectories of Drive C (NAME is the name of subdirectory)
(New Users see "About Directories and Subdirectories")
MOVE A FILE MOVE A FILE MOVE A FILE
If you want to move a file, use the up arrow and down arrow keys to
position the pointer next to the file to be moved. Then press the M key.
The message "To Path:" will appear. Typing in the pathname at the above
message copies the file to a new subdirectory (path). Type the name of
the drive and subdirectory that the file is to be moved to, then press
the Enter key. The file will be moved.
MOVE ALL MARKED FILES MOVE ALL MARKED FILES MOVE ALL MARKED FILES
You may want to move files from the root directory to a subdirectory or
vice versa, or from subdirectory to subdirectory. Mark the files to be
moved, then press the Alt and M keys. The message "Move Marked Files. To
Path:" will appear. Type in the name of the path (as described above)
and press the Enter key. The files will be "moved," which means they
will be copied to the directory you specified and deleted from the
current directory.
Suppose you have just copied a group of files, and you want to
immediately copy more files to the same path. DM has a feature that
allows you to copy files to the same path without having to type the
pathname each time. This is helpful if you are making backups from the
hard disk onto several floppy disks.
If you have already copied a group of files, and want to copy more files
to the same path, mark the files and press Alt C. When the message "To
Path:" appears, simply press the Enter key. The files will be copied to
the path you specified the last time you copied files.
Computer Tyme DOS ToolBox Users Manual Page 17
_______________________________________________________________
DELETE A FILE DELETE A FILE DELETE A FILE
To delete a file, use the up arrow and down arrow keys to position the
pointer next to the file you want to delete. Then press the D key. The
message "Delete (filename)? (Y/N)" will appear. Press Y for yes and the
file will be deleted. The DOS ToolBox does not have an undelete
function.
DELETE ALL MARKED FILES DELETE ALL MARKED FILES DELETE ALL MARKED FILES
Mark all the files that you want to delete, then press the Alt and D
keys. "Ready to Delete Marked Files? (Y/N)" will appear. Type "Y" for
yes. All marked files will be deleted.
CONTROLLING THE SORT ORDER CONTROLLING THE SORT ORDER CONTROLLING THE SORT ORDER
The order in which the directory is displayed is shown as "Sort:" in the
upper right window. If you want the directory listed in some other
order, press the S key. Five choices appear.
1) Name - Type 1) or "N" to sort alphabetically by filename. This is the
default sort order, which means files are automatically sorted this way
unless you change it.
2) Ext - Type 2) or "E" to sort by extension. This is helpful if you
want all the files with the same extension to appear together.
3) Date - Type 3) or "D" to sort chronologically.
4) Size - Type 4) or "S" to sort smallest to largest
R) Reverse - Type R) to reverse the sorted order.
(New Users: see "Files, Filenames and Extensions".)
RENAMING FILES RENAMING FILES RENAMING FILES
To rename a file, place the pointer at the desired file and press the R
(Rename) key. Then type in the desired new name and press Enter. Use the
arrow keys to position the pointer, and the Backspace (<--) or Delete
(Del) key to erase unwanted characters. You may move up and down the
list, changing the names of as many files as desired. Two files cannot
share the same name. If you try, you will get an error message "access
denied." Press the F3 key if you want to copy the name (not the
extension) of the file directly above the one you're working on.
Computer Tyme DOS ToolBox Users Manual Page 18
_______________________________________________________________
VIEWING TEXT FILES VIEWING TEXT FILES VIEWING TEXT FILES
If you want to view a text file you can set up DM to run your favorite
VIEW program on a selected file. DM has been set up to run the DOS VIEW
program as the default. The VIEW program must be installed in the same
directory as DM or its path must be specified during the setup routine.
To change the default and set up your VIEW program, choose X (Extra
Functions) and then choose V (Set VIEW Program). The message "Input the
Command for your favorite VIEW program" will appear. Type in the name of
your program, (and its path, if necessary), same as if were being
executed from DOS. (Examples: NW1 or C:\NW\NW1).
To view a file, position pointer next to a text or document file and
press "V". Program files (those with .COM, .EXE or .BAT extensions),
data base files and spreadsheet data files will probably be
unrecognizable. You may not revise text using View.
EDITING TEXT FILES EDITING TEXT FILES EDITING TEXT FILES
If you want to modify a text file you can use TEDIT or MarxEdit,
included in this package, or set up DM to run your favorite EDIT
program on a selected file. The program must be installed in the same
directory as DM or its path must be specified during the setup
routine. To set up your EDIT program, choose X (Extra Functions) and
then choose E (Set EDIT Program). The message "Input the Command for
your favorite EDITOR program" will appear. Type in the name of your
program, (and its path, if necessary), same as if were being executed
from DOS. (Examples: TEdit or C:\NW\Edit). To edit a file, position
arrow at text file and press "E". To save, press "CTRL KS". To save
and quit press "CTRL KD". To quit without saving, press "CTRL KQ". Use
caution in editing files. Do not attempt to edit files other than text
or document files. To do so could result in damage to program or
system files.
PATCHING A FILE PATCHING A FILE PATCHING A FILE
Warning: For advanced users only. If you want to patch a file you can
set up DM to run your favorite PATCH program on a selected file. The
program must be installed in the same directory as DM or its path must
be specified during the setup routine. To set up your PATCH program,
choose X (Extra Functions) and then choose P (Set PATCH Program). The
message "Input the Command for your favorite FILE PATCH program" will
appear. You may replace the name of the existing program or type in
another program name (and its path, if necessary), same as if were being
executed from DOS. (Examples: Patch or C:\UTIL\Patch)
To patch a file, position pointer at desired file and press "P". Patch
allows you to change programs in either ASCII or HEX. Do not attempt to
patch a file unless you know what you are doing, you could damage a
program or system file.
Computer Tyme DOS ToolBox Users Manual Page 19
_______________________________________________________________
CHANGE FILE DATE CHANGE FILE DATE CHANGE FILE DATE
Position the pointer at the file to be changed and press the T (Change
Date) key to change the date. If you want today's date, press the F2
key. (Note: for F2 to insert correct date, make sure your clock calendar
is set correctly). If you want the date of the file directly above the
one you're working on, press the F3 key. You may move up and down the
list, changing the date on any file. Press Enter when finished.
THE STATUS WINDOW THE STATUS WINDOW THE STATUS WINDOW
Disk statistics for the current drive are in the Status Window. The
"Size of Files" and "Free Space" figures are shown in "k." One "k"
equals 1024 characters. Therefore, 20k would mean 20,480 characters.
Just below "Path", the "Size" of the file currently at the pointer is
shown in actual number of characters (bytes).
The figure displayed under the "Total" column entitled "Size of Files",
shows the total "k" used by all files in the current subdirectory. The
same figure under the "Marked" column shows the number of "k" of all
marked files. Note: This figure is the actual amount of space required
on a floppy if you are copying the marked files to a floppy disk. The
"Marked" figure may differ from the "Total" figure when files are marked
because a hard disk requires a minimum of 2k clusters for each file,
while a floppy disk requires a minimum of only 1k clusters.
"Number of Files" under the "Total" column represents the actual number
of files in the subdirectory. The same figure under "Marked" represents
the total number of files currently marked. "Size:" shows the actual
number of characters in the file currently indicated by the pointer.
"Free:" shows the amount of space, in "k", still available on the
current disk.
DISK FREE SPACE DISK FREE SPACE DISK FREE SPACE
If you want to know the amount of free space on a disk, press the F
(Freespace) key. The message "Disk Statistics for Drive" will appear.
Type in the name of the desired drive (A or C), and statistics for the
disk in that drive will be displayed. For example, a disk in drive A
might read:
Total: 354k Cluster Size: 1024
Free: 120k Tot Clusters: 354
Used: 234k Percent Free: 33.8%
Computer Tyme DOS ToolBox Users Manual Page 20
_______________________________________________________________
The "Total" shows the capacity of the disk. When a file is created,
space for it is allocated in chunks, called "clusters." Therefore, the
"Cluster Size" is the minimum amount of space that may be taken up by a
file. (If the cluster size is 1024 bytes, then a file with only 500
bytes will still be considered to take up 1024 bytes, or one cluster.)
The Freespace command (F) is very helpful when you need to make sure
there is adequate room on a disk intended to receive copied files.
GOTO FILENAME GOTO FILENAME GOTO FILENAME
Rather than scrolling through a lengthy directory, you may go directly
to a specific file using the Goto Filename feature. Press the G key,
then type in the name of the desired file. Press Enter, and the pointer
will move to that filename.
RE-READING THE DIRECTORY RE-READING THE DIRECTORY RE-READING THE DIRECTORY
When you change the disk in your floppy drive, let the computer know
that there's a different disk in the drive. Press the L key (Re-read
Directory) to display the directory of the new disk.
CHANGING DISK DRIVES CHANGING DISK DRIVES CHANGING DISK DRIVES
The name of the current designated drive is in the Status Window, shown
as "Path:". If you want to scan the files on another disk drive, press
the F5 (Change Disk) key. Type in the name of the desired disk drive
(such as A or C). The new directory will be displayed in the File
Window.
CHANGING THE PATH CHANGING THE PATH CHANGING THE PATH
If you want to display the files in a subdirectory, then you have to
change the path. This is similar to changing the disk drive (see above).
Press the F6 (Change Path) key. This message will appear:
Change drive, path, or mask.
Usage: Drive:\Path\Mask
(See "Changing the Mask" below). Type in the desired pathname, such as
C:\NW then press the Enter key. For more about "mask" (See "About
Directories and Subdirectories" and "Changing the Path").
Computer Tyme DOS ToolBox Users Manual Page 21
_______________________________________________________________
CHANGING THE FILE MASK CHANGING THE FILE MASK CHANGING THE FILE MASK
Perhaps you have a big directory and don't want DM to show every file.
You may display a partial directory by "changing the mask." The term
"mask" is used to refer to a filename with appropriately embedded
wildcards. The "mask" or filename determines which files in a given
directory will appear in the File Window.
Normally, all files are shown, so the default mask is "*.*" (meaning
"every filename, and every extension"). Using a mask such as "*.doc"
would return all document files with a .doc extension regardless of
the filename. The mask currently in use is shown in the Status Window.
If you want to change the mask so that only certain filenames or
extensions are displayed, press the F6 (Change Path) key. This message
will appear: Change drive, path, or mask. Usage: Drive:\Path\Mask
Follow the usage example when typing in the drive, path, and the desired
"mask". The mask should be a filename with appropriately embedded
wildcards. (See "Wildcards").
Example: if you only want to display files with the .COM extension, then
press F6, specify *.COM as the mask and press ENTER.
TREE MODE TREE MODE TREE MODE
The Tree Mode displays a list of subdirectories in the current drive. It
may be used instead of the "Change Path" command to jump to a
subdirectory.
This is an example of how to use the Tree Mode: From the root directory,
press the F7 key to enter the Tree Mode. A list of all the
subdirectories on the current drive will appear. Position the pointer
at the desired subdirectory and press ENTER. All files for that
subdirectory will be listed. Want to know if there are additional
subdirectories off the current subdirectory? Press F7 once more.
Additional subdirectories, if any, will be displayed. To list files in
an additional subdirectory, position the pointer and press ENTER. When
listing files, you exit Tree Mode. To again enter Tree Mode press F7.
The message <Prev Dir> (Date) will appear. Press ENTER to return to
previous subdirectory file listing or Right Arrow to enter Tree Mode.
The Tree Mode is an alternative to using the "Change Path" (F6)
command.
F7 Enter and Exit Tree Mode
R Rename Subdirectory
-> Jump to SubDir - move to the next tier of subdirectories
<- Jump to SubDir toward Root - move to the next tier of
subdirectories toward the root
Computer Tyme DOS ToolBox Users Manual Page 22
_______________________________________________________________
RET Jump to SubDir and Exit Tree Mode - move to the
subdirectory indicated by the pointer and return to the
regular mode
\ Jump to Root Directory - move to the root directory
WILDCARD MARK WILDCARD MARK WILDCARD MARK
You may mark (highlight) a group of files at one time with the wildcard
feature. Wildcards are useful if you want to copy, move, delete or sort
a specific group of files whose filenames have common characteristics.
You can substitute the wildcard symbols (* and ?) into a filename, and
the computer will choose all files that fit into that category.
To use the wildcard feature, press W (Wildcard Mark), then type the
filename with the desired wildcard (* or ?) embedded in the proper
place. Press Return, and files will be marked. Example: Many word
processors create an automatic backup file. Suppose you want to delete
all your files that have the .BAK extension. You would press the W key,
then type *.BAK. This reads "any file which has the .BAK extension." All
BAK files will be marked and made ready for deletion. (New Users: see
"Wildcards".)
REVERSE MARKS REVERSE MARKS REVERSE MARKS
The "Reverse Marks" feature marks (highlights) all files that are not
marked, and un-marks all files that are marked. You can use this feature
if you want to copy, move or delete all except a few files. First, mark
(highlight) only the files you don't want to copy, move or delete. Then
press the X key (Extra Functions), and choose option R (Reverse all
Marks). You can use a combination of the "Wildcard Mark" and the
"Reverse all Marks" features. Suppose you wanted to delete all files
except those with the .COM extension. First, you would use the wildcard
mark to mark .COM files, then reverse the marks. Then all non-.COM files
would be marked, ready for deleting.
Computer Tyme DOS ToolBox Users Manual Page 23
_______________________________________________________________
CHANGING COLORS CHANGING COLORS CHANGING COLORS
If you have a color monitor, you may change DM's colors. Press the X
(Extra Functions) key, then choose option C (Set Colors). The Color Menu
will appear:
1 Turn Color Off
2 Background Color 3 Border Color
4 HiVideo Color 5 LoVideo Color
Esc Exit
DM comes up automatically in color on a color monitor. You can change
the colors of the background, the border, the bold or highlighted text
(HiVideo), or the regular text (LoVideo). You may choose between 15
different colors. When you have the colors the way you want them, press
the Esc key to exit to the Extra Functions menu, then type "S" to save
your new configuration to disk. Saving the configuration insures that
the program will always come up with your new colors on the screen.
EXECUTE A DOS COMMAND EXECUTE A DOS COMMAND EXECUTE A DOS COMMAND
You may execute any DOS command directly from DM. Press the F4 (DOS
Command) key, and then type the desired command, just as you would from
DOS. Press Enter, and the command will be executed. When it is finished,
press any key to return to DM, exactly where you left off. Note: For
this feature to work, you must have the COMMAND.COM file on your hard
disk or the disk that was used to boot the system.
EXECUTE A FILE EXECUTE A FILE EXECUTE A FILE
You don't have to type the full DOS command to execute a file. Instead,
you may position the pointer next to the file that you want to execute,
then press the F3 (Execute File) key. If the file is executable, (has an
extension of .EXE, .COM or .BAT) the program will run and you will leave
DM. When you are finished running the program, you will automatically
return to DM exactly where you left off. (If the file is not executable,
nothing will happen.)
This feature executes a file in the same manner as if you were in DOS.
Position the pointer at an executable file. When you press F3, the
filename appears in the Popup Help Window. Press the ENTER key to
execute the file, or, if you wish, you may type more parameters onto the
command line, such as a pathname or the name of the file to be loaded
and run. Use standard DOS syntax if you type any additions to the
command. For example, suppose you are marking files to be moved or
copied to a disk in drive A and you realize you don't have a formatted
disk to copy them to. To continue your project you must first format a
disk in drive A. (The FORMAT program must be in the current directory on
Drive C.) Place the pointer next to the FORMAT file, and press F3. The
following message will appear:
Computer Tyme DOS ToolBox Users Manual Page 24
_______________________________________________________________
___k Memory Available.
Type Text Into Command Line.
FORMAT _
You will have to type A: at the cursor to indicate that you want the
disk in drive A formatted, then press ENTER. The line "___k Memory
Available" tells you how much resident memory (RAM), in "k," is
available to execute the file at the pointer. If the file you've picked
is larger than the available memory, you can't execute it. The amount of
memory available depends on what kind of computer you have. DM takes up
about 100k of memory, so if your computer only has 128k of RAM, don't
plan on being able to execute anything except the smallest of files.
Computers with 256k may have some difficulty executing large files.
Those with 512k or 640k shouldn't have any trouble at all.
PROGRAMMABLE FUNCTION KEYS PROGRAMMABLE FUNCTION KEYS PROGRAMMABLE FUNCTION KEYS
+-----------------------------------------------------------------+
| +------------------------------------+ |
| | Programmable Function Key Settings | |
| +------------------------------------+ |
| |
| Alt-F1 List SubDir Tree Alt-F2 NW Non Doc Mode |
| Alt-F3 NW Doc Mode Alt-F4 Run File Patch |
| Alt-F5 Smart Spreadsheet Alt-F6 Smart Word |
| Alt-F7 Fast Arc Extract Alt-F8 QEdit File |
| Alt-F9 Arc File Alt-F10 PkArc File |
| |
| Ctrl-F1 Chkdsk Ctrl-F2 Pick Directory |
| Ctrl-F3 Memory Res Progs Ctrl-F4 Park Hard Disk |
| Ctrl-F5 Zip File Ctrl-F6 Ice File |
| Ctrl-F7 Type File Ctrl-F8 Programs that Run |
| Ctrl-F9 Directory of A: Ctrl-F10 MarxEdit File |
| |
| Shft-F1 Format A: 360k Shft-F2 Format A: 360k /S |
| Shft-F3 Format A: Shft-F4 Format A:/S |
| Shft-F5 Format B: 720k Shft-F6 Format B: 720k/S |
| Shft-F7 Format B: 1.4m Shft-F8 Format B: 1.4m/S |
| Shft-F9 Directory of A: Shft-F10 Directory of B: |
| |
+-----------------------------------------------------------------+
Computer Tyme DOS ToolBox Users Manual Page 25
_______________________________________________________________
You may custom program up to 30 key combinations to do special tasks.
You can program these keys to execute any program, DOS command or batch
file. These keys can be programmed so that you can position the pointer
next to a file, press the Function Key combination, and run the
appropriate program on that file. The 30 keys which may be programmed
are the Alternate Function keys (Alt F1-F10), the Control Function keys
(Ctrl F1-F10) and the Shift Function Keys (Shft F1-F10). For help,
press the "Tab" key to view the default Programmable Function Key
Settings. For information on reprogamming the Keys, go to Help Screen
No. 2 by pressing F1 twice. To begin reprogramming press F8 and choose
1) Change Alt Function Keys; 2) Change Ctrl Function Keys or 3) Change
Shft Function Keys.
Programmable Function Keys allow you to write a command to tell the
computer what to do when that key combination is pressed. You will write
commands using regular DOS syntax for the command line. (See "About the
Command Line") At the same time you write a DOS command for the
key combination, (Alt-F1) for instance, you will also need to write
the "help text." This will appear on the screen entitled "Programmable
Function Key Settings" so that you will remember what the key does.
You may want to program a key combination to execute a file that takes
up a lot of memory. Since DM takes up about 100k of RAM, be sure that
your computer has enough memory to execute your commands. (See "Execute
a File"). In the examples below, we will assume that you have a
hard disk computer with at least 512k of RAM. Here are a couple of
uses for the Programmable Function Keys. The DOS commands and help
text are included.
Command Help Text Explanation/Use
FORMAT A: Format Formats a disk in drive A. This is
helpful if you have files marked to
be copied to a floppy disk, and have
forgotten to format a disk.
DIR A:/P Dir A: Reads the directory of the disk in
drive A, pausing when the screen is
filled.
For practice, let's program Function Keys for the two above examples.
Press the F8 (Edit Commands) key to pick an option:
1 Change Alt Function Keys
2 Change Ctrl Function Keys
3 Change Shft Function Keys
4 Change AutoRun Commands
Computer Tyme DOS ToolBox Users Manual Page 26
_______________________________________________________________
Don't choose option 4 now. Instructions for the Autorun Key come later.
For this practice session, let's program the Alt F1 and Alt F2 keys.
Therefore, choose Option 1, "Change Alt Function Keys." The following
display will appear in the File Window.
================================
| Esc to Exit Help Line: 1
| Alt F1 .... _
| Alt F2 ....
| Alt F3 ....
You will type in your help text and DOS commands on these lines. The
first line is for the help text for the Alt F1 key. The next line is the
DOS command for the Alt F1 key. Use the arrow keys to position the
cursor on the desired line. The "line guide" in the upper right-hand
corner of the window tells you which line the cursor is on. Using our
two examples, type the help text on the help line and the command on the
command line for each key, as shown below.
================================
| Esc to Exit Command Line: 2
|
| Alt F1 ......Format
| FORMAT A:
| Alt F2 ......Dir A:
| DIR A:/P _
| Alt F3 ......
When you've finished typing in the help text and commands, press the Esc
key, then test your newly programmed keys. After testing, you must save
the configuration of your newly programmed Function Keys to disk in
order for them to be there the next time you use the program. Type "F8"
and choose option (6) "Save to DM.COM."
PROGRAMMING WITH VARIABLES PROGRAMMING WITH VARIABLES PROGRAMMING WITH VARIABLES
The Programmable Function Keys allow you to execute programs and DOS
commands on files. This may be accomplished by using variables. The
variable {F}, means filename. This tells the computer to perform a
command on whatever filename is next to the pointer.
Suppose that you want to program the Ctrl F4 key to execute the WORDSTAR
Word Processor (filename WS). Position the pointer next to any of your
WORDSTAR data files (your letters, reports, etc.) and then, when you
press the Ctrl F4 key, the computer executes the word processor and
opens the file next to the pointer. Your DOS command for the Ctrl F4 key
would read: WS {F}
The following are valid variables for DM. Variables used in the command
line must be put in brackets {}.
Computer Tyme DOS ToolBox Users Manual Page 27
_______________________________________________________________
{F} = FileName {P} = Path
{T} = Type in Text {D} = Drive
{N} = Name no Ext {E} = Ext no Name
{S} = Allow Program to Change Subdirectory
{A} = Press Any Key to Return to DM
The chart below shows some uses of the Programmable Function Keys using
variables.
Command Help Text Explanation/Use
TREE {A} List Tree Executes the Tree program, which
displays all the directories and
subdirectories on the disk in a
"tree" structure. Pauses before
returning to DM.
CHKDSK {A} Chkdsk Tells how much space is used up on
the disk, and and how much memory
is free. Pauses before return-
ing to DM.
BASIC {F} Basic Executes the Basic program and
loads the data file next to the
pointer.
WS {F} WORDSTAR Executes the WORDSTAR word
processor, and loads the data
file next to the pointer.
To continue the practice programming session, the preceding four commands
and help text could be entered for the Alt F3, Alt F4, Alt F5, and Alt
F6 keys on the Edit Commands (F8) menu. Press F8 and choose Option 1.
================================
| Esc to Exit Command Line: 2
|
| Alt F1 ......Format
| FORMAT A:
| Alt F2 ......Dir A:
| DIR A:/P
| Alt F3 ......List Tree
| TREE {A}
| Alt F4 ......Chkdsk
| CHKDSK {A}
| Alt F5 ......Basic
| BASIC {F}
| Alt F6 ......WORDSTAR
| WS {F}
Computer Tyme DOS ToolBox Users Manual Page 28
_______________________________________________________________
There are many other possibilities for the Programmable Function Keys.
Decide what tasks you would like your keys to do. It might help to make
a chart like the ones above. Then enter your commands and help text as
shown in the examples.
If you are going to be using software in one directory and files in
another, you will need to specify the drive and path in your DOS
commands. They were omitted from the examples given above for the sake
of simplicity. The above commands with pathnames might read:
C:\UTIL\TREE {A}
C:\UTIL\CHKDSK A: {A}
C:\BASIC {F}
C:\WS {F}
When you're finished, press the Esc key. Then test your newly programmed
function keys. You may need to go back and fine tune some of your
commands.
SAVING YOUR PROGRAMMING SAVING YOUR PROGRAMMING SAVING YOUR PROGRAMMING
When you are happy with the way the keys work, then you are ready to
"save" the changes. If you don't save them, they won't be there next
time you use DM. However, once they're saved, they can't be accidentally
changed until you "save" something new.
To save your Custom Programmed Function Keys, press the F8 key. Choose
option 6 (Save to DM.COM). Your changes will be saved to disk.
Since DM takes up about 100k of memory, it uses up space that would
ordinarily be used to execute your program. It is not recommended that
you use DM to execute files for everyday use. In other words, you should
execute your programs directly from DOS to work on your database files,
spreadsheet files, or word processor files. The purpose of executing a
file directly from DM is to look at a file to see what's in it, not to
work on it. DM can only execute DOS commands as they would be entered on
the command line. If you can't do something from the DOS command line,
you can't do it from DM.
Some software programs are written with internal limitations that make
them unsuitable for loading with data files directly from DM. DM can't
make the function keys do something with your software that your
software won't do in the first place. Remember the test: If you can't do
it from the DOS command line, you can't do it from DM.
Computer Tyme DOS ToolBox Users Manual Page 29
_______________________________________________________________
THE AUTORUN KEY THE AUTORUN KEY THE AUTORUN KEY
Just like the Programmable Function Keys, the AutoRun (F2) Key has the
capability of executing a program or a DOS command on a selected file in
one keystroke.
The AutoRun Key is different from the Programmable Function Keys. You
can use the same key to run any number of programs, or execute any
number of DOS commands. You only have to remember one key (F2).
The important difference between the AutoRun (F2) Key and the
Programmable Function Keys is that the AutoRun Key looks at the
extension of the file at the pointer, and executes a DOS command that
you have programmed to run on all files with that extension.
Suppose you program the AutoRun Key to run the BASIC program with any
file which has a .BAS extension. If you positioned the pointer next to a
file named (for example) ALIENS.BAS and pressed the AutoRun (F2) Key,
the BASIC program will execute with the ALIENS.BAS file loaded.
The AutoRun Key won't automatically work for your software. You must
program this key yourself before it will work. If the key isn't
programmed, nothing will happen when you press it.
When you press the AutoRun Key, the computer will look at the extension
of the file next to the pointer and execute the command you have
designated for a file with that extension.
The first step to custom programming the AutoRun Key is to make a list
(on paper) of the extensions of files you want to execute programs on.
Next, write a DOS command to correspond with each extension. See
examples later in this section.
You will need to use variables in the commands, like you did when you
programmed the Function Keys (see above). The following are valid
variables for DM.
{F} = FileName {P} = Path
{T} = Type in Text {D} = Drive
{N} = Name no Ext {E} = Ext no Name
{S} = Allow Program to Change Subdirectory
{A} = Press Any Key to Return to DM
Suppose you want to program your AutoRun (F2) key to run BASIC, loaded
with the file next to the pointer. You may remember the command that we
used in the example for the Programmable Function Keys: C:BASIC {F}
Since the AutoRun Key looks only at the extension, you will program your
commands a little differently than you did with the Function Keys. Use
the following format:
Computer Tyme DOS ToolBox Users Manual Page 30
_______________________________________________________________
Extension=DOS command
So, the command for your BASIC program would be:
BAS=BASIC {F}
You may program the AutoRun (F2) Key to execute any DOS command. The
command will be executed on the file at the pointer.
Suppose you have the WORDSTAR word processor. It makes backup files with
the extension .BAK. If you don't want to to keep backup copies set up
the command:
BAK=DEL {F}
If you positioned the pointer at a file named LETTER.BAK and pressed
(F2), LETTER.BAK would be deleted.
Suppose you set up the command COM={F}. What would happen if you placed
the pointer next to a file called PACKMAN.COM and pressed F2? That's
right, PACKMAN would run.
Remember the test that you learned while programming the Function Keys?
The rule is: If you can't do it from the DOS command line, you can't do
it from DM. Test your commands directly from DOS, so that you will be
sure that they work.
When you have tested all your commands, and have written them in the
"Extension=DOS command" format, you are ready to enter them into DM.
For practice, let's enter the three examples given above.
BAS=BASIC {F}
BAK=DEL {F}
COM={F}
Press the F8 (Edit Commands) key. Pick option #4 "Change AutoRun
Commands." The following will appear on the screen:
====================================
| Edit AutoRun Strings
|
|
|
|
Type in the commands. Use the arrow keys to move around the screen and
the backspace key to correct mistakes.
Computer Tyme DOS ToolBox Users Manual Page 31
_______________________________________________________________
====================================
| Edit AutoRun Strings
| BAS=BASIC {F}
| BAK=DEL {F}
| COM={F}
|
Press Esc when you are finished typing commands. Test them when you are
finished. If the commands do what you want you are ready to save the
changes. If you don't save them, they won't be there next time you use
DM. However, once they're saved, they can't be accidentally changed
until you "save" something new.
To save your AutoRun commands, press F8, then choose option "5" (Save to
DM.OVL). Your changes will be saved to disk.
ABOUT FILE ATTRIBUTES ABOUT FILE ATTRIBUTES ABOUT FILE ATTRIBUTES
An attribute is a special characteristic assigned to a file by the
computer or the user. If a file has any attributes, they will be listed
in the Status Window when the pointer is positioned next to that file.
The following briefly explains the four types of attributes.
Hidden: A "hidden" file will not be listed in the DOS directory. (If you
type the command "DIR" you won't see it.) It will be listed in the DM
directory.
System: This is a file that the computer uses internally. You should
never mess with system files. You do want your system to boot next time
you turn it on, don't you?
Read Only: A "read-only" file is write protected, which means it can't
be changed. It also can't be deleted under DOS. But it can be deleted
with DM. You might want to change a file to "read only" if you don't
want anyone fooling with it.
Archive: When you run the utility program which backs up the hard disk,
the program sets an "archive flag" on each file, which tells the system
that "this file has been backed up." If you later modify that file, the
archive flag is wiped out. Then, the next time the backup utility is
run, it skips over files with archive flags, because they've already
been backed up. There isn't any reason to change an archive attribute.
Computer Tyme DOS ToolBox Users Manual Page 32
_______________________________________________________________
CHANGING FILE ATTRIBUTES CHANGING FILE ATTRIBUTES CHANGING FILE ATTRIBUTES
Warning: Do not use this unless you fully understand attributes and have
a reason to change one.
To change an attribute, place the pointer next to the file to be changed
and press A (Change Attribute). The following screen will appear:
Hidden System Read-Only Archive
S to Set
R to Reset |HSRA|
Space to Ignore |_ |
The letters in the brackets |HSRA| stand for: H=Hidden, S=System, R=Read
Only, and A=Archive
You will type one of the codes shown on the screen below each of the
letters |HSRA|. They mean:
S to Set - An S sets that attribute to "on" for the file indicated by
the pointer.
R to Reset - R sets that attribute to "off" for the indicated file.
Space to Ignore - A space leaves the attribute as it is:
Example: |HSRA|
|S |
This would set the hidden attribute for this file. All other attributes
would remain as they were. If you want to change the attributes of a
number of files at one time, mark (highlight) the desired files, then
press Alt A (Change Attributes for Marked Files). Set the attributes as
described above. The attributes you choose will be set for all marked
files.
Computer Tyme DOS ToolBox Users Manual Page 33
_______________________________________________________________
FOR NEW USERS FOR NEW USERS FOR NEW USERS
This section is for the novice and provides an introduction to MS-DOS
functions and commands that relate directly to DM. If you are familiar
with DOS you may wish to skip this section and go directly to "Using
"DM" Directory Master." Consult your MS-DOS manual for a more in-depth
explanation of DOS functions, or commands.
Throughout this manual, you will be asked to press the "Enter" key. On
some keyboards, it may be called the "Return" key, and on others it is
simply marked with a "<--+ Regardless of how it is labeled, you want to
press the key that gives you the equivalent of a carrier return. Also,
throughout the manual we refer to the "prompt" as C:. The prompt on your
computer may appear as C> or variations thereof. All commands introduced
in this section are executed while at the DOS command line. If the
prompt is on the screen, you are at DOS. (See Displaying Current
Directory at Prompt).
Turn on the computer. When the "C:" prompt appears, the computer is
ready to accept commands. The hard disk is called drive C, and the drive
for floppy disks is Drive A. Drive C is the default drive.
If you get stuck and want to start over, you can "reboot" without
turning the machine off. Press the CTRL, ALT and DEL keys simultaneously
or, on some machines, the reset button on front of the machine. Be
careful. Never reboot if you haven't saved your work because it may be
lost.
When the computer is first turned on, it will search for files on the
default drive, for instance C:. If you want it to search for files on
another drive, you must know how to access another drive. If Drive C: is
the drive you are presently in, then "C>" will be the prompt. To change
drives type the letter of the desired drive, followed by a colon, then
press Enter.
C: (Prompt for current designated drive)
C: (to change designated drive to drive A,
type "A:" and then press Enter)
A: (the new prompt appears, showing that
A is now the designated drive)
FORMAT A DISK
Formatting a blank disk prepares it to be used by your computer. The
disk is divided into "sectors" which could be compared to drawing lines
on a sheet of paper in preparation for writing a letter. Every disk
that you use must be formatted.
Computer Tyme DOS ToolBox Users Manual Page 34
_______________________________________________________________
Formatting a disk erases everything on the disk. You must specify Drive
A by typing the "A:" after "FORMAT". On hard drive systems, if you
forget the "A:" or if you make a mistake and type "A;" then the default
drive (Drive C) will be formatted. Since this is the hard disk, this
means that everything on the hard disk will be erased! The correct
command should look like this: FORMAT A:
Read warning above before you do anything. Then put a blank disk in
Drive A. Bring up the "C:" prompt and type: FORMAT A: Press Enter, and
the disk in Drive A will be formatted.
STEPS FOR MAKING A BACKUP
You should always make a backup of each of your software disks. The
backup, or working copy, is for everyday use. Put the original in a safe
place. Then, if something happens to the working copy, you can make
another copy from the original.
1) Have your program diskette and a blank diskette ready.
2) Bring up the "C:" prompt and type "DISKCOPY A: A:" and then press the
Enter key. This tells the computer to copy the disk in drive A to
another disk which will later be put in drive A.
3) Follow the instructions on the screen. The program diskette is the
"source" and the blank diskette is the "target."
Note: Your blank disk does not need to be formatted in advance. The
"DISKCOPY" command formats the disk at the same time that the files are
being copied.
FILES, FILENAMES, AND EXTENSIONS
All programs, text, or data on your disk are contained in files. A
letter created by your word processor is in a file, as is a list of
names and addresses in a database. A file on a disk can be compared to
a file folder in a drawer.
Every file has a filename, which allows the computer to keep track of
files. Filenames may have two parts: the "name" and the "extension".
These are separated by a period. For example, DM.COM is DM's filename.
A name may be up to eight characters long but the extension is limited
to three characters. The extension is optional. All of the following
are valid filenames: LETTER.DOC, DATA.DB, MOMLET, Q, OK.TXT, 123.WS.
WILDCARDS
Sometimes you may want to give the computer a command that will affect
more than one file. For example, you may want to delete all the files
with the extension .BAK. Wildcards allow you to do this all at once,
rather than going through and deleting them one-by-one.
Computer Tyme DOS ToolBox Users Manual Page 35
_______________________________________________________________
Two characters, the question mark (?) and the asterisk (*) may be
used as "wildcards" in filenames and extensions.
The computer interprets a question mark (?) as "any character" (a
wildcard for a single character). If you had a set of files, for
example, with the names JONES1.DOC, JONES2.DOC, JONES3.DOC, etc., you
could denote the whole set with the name JONES?.DOC.
The computer interprets the asterisk (*) as "any set of characters" (a
wildcard replaces a whole filename or any part of a filename).
Therefore, *.COM would mean "any file with the .COM extension." FUN.*
would mean any file with the name FUN with any extension. *.* means
"all files, all extensions."
Wildcards (? and *) may not be used in filenames. Rather, they are only
used in commands to select a group of files for moving, deleting,
copying, etc. An example of usage for wildcards is shown below.
DEL MAIL.* (all files named MAIL would be deleted)
DIR TEST?.DOC (a directory will be displayed for all
files starting with TEST with the .DOC
extension.)
COPY *.COM A: C: (all files with the .COM extension would
be copied from drive A to drive C.)
ABOUT DIRECTORIES AND SUBDIRECTORIES
A directory and a subdirectory are different names for the same thing. A
directory keeps track of your files on a disk. The directory has
information about the name, size, location, and date of creation (or
last updating) of all the files on a disk. The root is normally
referred to as the root "directory" and all directories branching off
the root are referred to as "subdirectories".
DISPLAYING A DIRECTORY USING DOS
"DIR" is the DOS command to display the directory of the current
designated drive. Other commands to show a directory are:
DIR B: (Shows directory of Drive B: or whatever
drive is specified)
DIR/P ("Page mode" causes the scrolling of directory
to stop when the screen is filled.
DIR/W ("Wide Display" shows directory of the
current drive in several columns across
the screen. Only filenames are displayed.)
Computer Tyme DOS ToolBox Users Manual Page 36
_______________________________________________________________
DM's main purpose is to help keep track of directories better than is
possible with DOS alone. You probably won't need to use the DOS
directory display commands often after you learn DM. (See also "D", a
sweet little directory program.)
SUBDIRECTORIES
If you have several different projects, each with its own files, or if
many people are using the same computer, the directory may become long
and unwieldy. You may want to categorize your files or keep them
separate from another person's. "Subdirectories" allow you to group
files separately, much as you would group files in separate drawers of a
filing cabinet.
Subdirectories are most commonly used on a hard disk, but diskettes may
also have subdirectories. For the purpose of this discussion, we will
assume that your subdirectories are on Drive C:, the hard drive.
Any directory may have subdirectories. This creates a "tree" structure.
The "root" is the first level of directory system, and is the trunk of
the tree. Subdirectories (off the root directory) may be thought of as a
limbs on the tree. Files within a subdirectory are branches on the limb.
An example of a typical directory structure or "tree" is shown
below:
--ROOT---+-PROGRAMS----+-PROCOMM
| |-TWIN
| |-BASIC
| |-WORDSTAR
|
+-USERS-------+-TOM
| |-DICK
| |-HARRY--+-GAMES
| |-ACCOUNTS
+-MUSIC
+-GOODIES
+-UTIL
PATHS AND PATHNAMES
You can access any file in any subdirectory on your disk. To do this,
you must tell the computer where in the "tree" that the file is located.
Starting with the root directory, you must give the "path" to the
desired file. The "pathname" is one or more directory names separated by
one or more backslashes (\). In the tree above, the pathname for the
subdirectory named TWIN would be written as:
C:\PROGRAMS\TWIN
Computer Tyme DOS ToolBox Users Manual Page 37
_______________________________________________________________
The symbol for the root directory is "\", so the root directory on Drive
C is written as "C:\". A subdirectory's name is written as "C:\NAME"
(NAME is whatever name you gave to the subdirectory).
ACCESSING A SUBDIRECTORY
If you want the computer to search for files in another subdirectory,
you must change directories. At the DOS command line, the command for
"change directory" is CHDIR or CD, followed by the pathname.
Suppose that Harry, who uses the computer with the "tree" shown above,
wants to play games. He must type the change directory command, plus the
pathname, to get to his UTILITIES subdirectory. From the C: prompt, he
will type:
C:CD USERS\HARRY\UTIL (change directory command)
C:\USERS\HARRY\UTIL (prompt in new directory)
The symbol for the root directory is "\". So, to return to the
root directory, he will type:
C:\USER\HARRY\UTIL: CD\ (command to return to root)
To create a subdirectory, type the command "MD" (make directory) and the
name that you choose for the directory. Suppose you wanted to name your
directory "TEST." From the C: prompt, type:
MD TEST
Perhaps you want to make a subdirectory within the directory TEST that
you just created. You want to call it NEXTTEST. First, change to the
TEST subdirectory by typing CD TEST then from the C:\TEST prompt, type:
MD NEXTTEST. (See also "Displaying Current Subdirectory at Prompt"). To
change to new subdirectory type CD NEXTTEST and the current directory
should be displayed as C:\TEST\NEXTTEST:.
Directory names are limited to eight characters. The entire pathname is
limited to 64 characters.
REMOVING A SUBDIRECTORY
RD is the "remove directory" command. The command must be followed by
the pathname, using the same syntax as for making a directory or
changing directories. You cannot be in the subdirectory you are trying
to remove and you can only remove a subdirectory if it is empty.
ABOUT THE COMMAND LINE
DOS commands are typed next to the prompt. This is called the command
line. Commands are executed when you press the Enter key. Commands
are used to execute DOS commands or to execute application programs.
Computer Tyme DOS ToolBox Users Manual Page 38
_______________________________________________________________
Format 1: Executing a DOS Command
COMMAND SYNTAX - [C:][\PATHNAME][\FILENAME]
COMMAND is the actual DOS command, such as DEL, DIR, CD, etc.
[ ] indicates that this part of the command is optional
C: is the name of the required drive, either A:, B: or C:
\PATHNAME is the pathname where the command should execute
\FILENAME is the name of the file on which the command should be
executed.
If you typed the command:
DEL C:\GAMES\SOLITAIR
you would then delete the SOLITAIR file in the GAMES subdirectory on
drive C:. If you were already in the GAMES subdirectory, your prompt
would be C:\GAMES and it would not be necessary to specify the drive and
pathname. You would only have to type "DEL SOLITAIR".
Format 2: Executing a File.
COMMAND SYNTAX - [C:][\PATHNAME\]FILENAME1 [FILENAME2]
[ ] indicates that this part of the command is optional
C: is the name of the required drive
\PATHNAME is the pathname where the command should execute
FILENAME1 is the name of the file (program) that should be
executed. It must be an "executable" file (have the
extension .COM, .EXE, or .BAT.)
FILENAME2 is the name of a data file that may be loaded (transferred
into memory) using the program in (FILENAME1).
Using our sample "tree" shown earlier, suppose the WORDSTAR subdirectory
contained the following files:
WS.COM (the WORDSTAR word processing program)
LETTER (text file for WORDSTAR)
If you typed the command:
C:\PROGRAMS\WORDSTAR\WS LETTER
Computer Tyme DOS ToolBox Users Manual Page 39
_______________________________________________________________
the WS file would be executed with the LETTER file loaded. If you were
already in the WORDSTAR subdirectory, you would only have given the
command: "WS LETTER". And, if you didn't want to load the LETTER file,
your command would simply be "WS".
a) WS is the command used to execute the program (File #1) named WS.COM;
and
b) LETTER is the data file (File #2) which will be loaded into memory.
Some of the control characters used by the WORDSTAR word processor and
other programs may be used in DM. These characters are valid for
scanning or marking files in a directory:
Ctrl E - cursor up Ctrl R - screen
Ctrl X - cursor down Ctrl C - screen down
Ctrl D - mark file Ctrl S - un-mark file
The following characters are valid in the edit mode:
Ctrl D - cursor left Ctrl S - cursor right
Ctrl G - erase character
TECHNICAL SUPPORT BBS TECHNICAL SUPPORT BBS TECHNICAL SUPPORT BBS
Computer Tyme has set up a bulletin board dedicated to supporting our
software users. The number is 417-866-1665, and it's open 24 hours a
day. You will need a 1200, or 2400 baud modem, and terminal software to
support ANSI graphics.
PD.EXE - PICK DIRECTORY PD.EXE - PICK DIRECTORY PD.EXE - PICK DIRECTORY
This program allows you to change directories as quickly as possible.
"PD" "Pick Directory" (also called "PickDir"), written for all user
levels, allows you to change directories as quickly as possible. It also
allows you to rename directories, delete directories, make directories,
and hide directories.
Pick Directory has two modes of operation; the graphic tree mode, and
the one directory at a time mode. In the graphic tree mode you get to
see all subdirectories "the tree" displayed as a picture on your screen.
This graphic "tree" allows you to "look" at the directory system in your
computer. In the graphic tree mode you can use your arrow keys to move
freely about the directory tree. Pick Directory allows you to rename any
of the directories, make new ones, delete them, or hide them.
Computer Tyme DOS ToolBox Users Manual Page 40
_______________________________________________________________
In order to display and use the graphic tree mode a file must be created
which contains a list of the directories on your system. The file is
called PD.PIC and MUST BE PATH ACCESSABLE. In this file is a list of all
directories you want Pick Directory to choose from. An example is as
follows:
C:\
C:\GOODIES
C:\HELP
C:\TURBO5
C:\TURBO5\BONUS
C:\TURBO5\DOC
C:\TURBO5\TURBO3
D:\
D:\GEMAPPS
D:\GEMAPPS\FONTS
D:\GEMAPPS\GEMPAGES
D:\GEMAPPS\GEMPAGES\PAGENBRS
Note that the list can span several drives. The list is created the
first time you run Pick Directory. The program will ask you which drives
you want to include in your list. Don't include floppy drives A: or B:.
If you only have one hard disk just type C. If you have several hard
drives or logical drive partitions, you might type CDEF. Pick Directory
will then create the PD.PIC file and display the graphic tree. Once in
the graphic tree you can move around using your arrow keys.
Remember that F1 is for help in case you forget what to do. The + and -
keys allow you to move up and down in the same column you're in. When
you get to the directory you want all you have to do is press ENTER and
you're there. If you want to go back to the original directory instead,
just press ESC.
As you move through the graphic tree, you'll notice an alphabetical
listing on the right side of the screen that tracks the directory you're
in. By pressing the TAB key, the up and down arrows allow you to move
through the alphabetical list. While moving alphabetically, each
subdirectory highlighted on the alphabetical list will also be
highlighted on the full screen graphic tree. Also, above the sorted list
is the position meter. This meter lets you know where you are in
relation to all the other directories in your computer.
You can use "GOTO" to quickly get to a directory while in the alpha
list. Just type "G" and the first few letters of the subdirectory you
want to go to. The cursor will move to that directory. As you type, Pick
Directory will move to the first directory that contains the characters
you typed in.
The "F" key shows you the free space on the current drive. It also shows
you how many directories are in the system and how many levels deep they
are.
Computer Tyme DOS ToolBox Users Manual Page 41
_______________________________________________________________
You can rename a directory by pressing the "R" key. A cursor will appear
and you just type over the old name. You can also delete a whole
directory by pressing the "D" key. If the directory isn't empty, it will
ask if you want to delete it anyway. If you answer "Y" then it will
delete that directory and all directories branching off from it and all
the files in them. Be careful! Remember to make regular backups.
You can also make directories using the "M" key. Just type in the name
and Pick Directory will create the directory off of the current
directory. The "H" key is used to hide and unhide directories. A hidden
directory will not show up if you type DIR. It's still there, just
hidden.
Directories can be created and deleted without the PD.PIC file being
updated. This means that the graphic tree may show directories that are
no longer there, or not show new directories that are. The "S" key will
scan the hard drives and re-create the list. If while moving around, you
come to a directory that no longer exists, Pick Directory will
automatically update the list for you.
The "L" key is used to limit the number of directory levels to be
displayed. This is used on very large systems to make it easier to see
the directories close to the root. If you set a limit of 2, Pick
Directory will only show directories that are 2 or less levels deep.
Setting a level of 0 includes all directories. Just type "L" to set
limit.
In order for Pick Directory to work the program PipeDir must be in a
directory that can be executed from the current path. (See the PATH
command in your DOS manual.) PipeDir is another Computer Tyme program
that creates the PD.PIC file and allows Pick Directory to delete
directories with files in them.
Pick Directory's other mode is the one directory at a time mode. In this
mode, only the directories that are accessable from the current
directory are listed. You choose the directory by pressing the letter
next to the directory you want. A lower case letter will select the
directory and let you choose from the list of it's directories. Upper
case selects and exits. Pressing the CTRL key with a letter selects that
drive. "\" selects the root directory and a "-" selects the previous
directory. Press ENTER when you get to where you want to go. ESC to
abort.
Even though the one directory at a time mode is not as powerful as the
graphic tree mode, it has its place. It doesn't use the PD.PIC file so
it doesn't have to be updated. It works on drives that you may not
want to wait to scan, such as CD roms. And, if you are running
computers remotely over a modem, this mode works.
If the directory or drive you are on is not in the PD.PIC file, then the
one directory at a time mode will be selected.
Computer Tyme DOS ToolBox Users Manual Page 42
_______________________________________________________________
Pick Directory has several command line options. Many of them are for
the sophisticated user and can be ignored by the novice user. Pick
Directory, like other Computer Tyme products, is easy to use for the
novice and small system user; but has powerful features for the
professional programmer and for use on large network drives.
PD <directory>
This is a quick way to change directories. Pick Directory will scan the
list for the closest match and switch you to that directory. A partial
directory name is all you need. The directory doesn't even have to be on
the same drive.
PD /S <drives> This creates the PD.PIC file without entering the graphic
tree mode.
PD /F This freshens the PD.PIC file without entering the graphic tree
mode.
PD /M <directory> This makes the directory and updates the PD.PIC file.
PD /R <directory> This removes the directory and updates the PD.PIC
file.
PD /Z Selects the "one directory at a time" mode.
PD /O This option can be used only with the /Z option. It forces the use
of the standard output device. You loose color and speed, but it will
work remote over a modem.
PD /$ <filename> This allows you to use another file than C:\PD.PIC.
PD /! <program> <parameters> Pick Directory normally runs PIPEDIR to
create its pick file. If you are a programmer and want to use your own
program to create the pick file, this command will make Pick Directory
run your software instead. The <parameters> is passed on to your
program.
Use of environment strings:
Default options can be selected by use of the SET command to set you DOS
environment strings. This is done by typing SET PD.EXE=<string>. The
string will be interpreted as if it had been typed on the command line.
You are the sysop of a BBS system and are running it remote. In your
AUTOEXEC.BAT file you include:
SET PD.EXE=/Z/O
This allows you to type PD from remote and enter the one at a time mode
with the standard output device selected.
Computer Tyme DOS ToolBox Users Manual Page 43
_______________________________________________________________
You are the supervisor of a large novell network and a programmer. You
want Pick Directory to only show the users the directories they can
access. You have written a program that compiles a pick file based on
who they are. Your program name is called PICKGEN. You want each user to
have their own pick file.
SET PD.EXE=/!PICKGEN /$F:\SYSTEM\USER1.PIC
This selects the file F:\SYSTEM\USER1.PIC to be the default pick file
for station 1 and will execute PICKGEN to regenerate and update the pick
file.
DOLIST DOLIST DOLIST
DoList is a dual purpose program. It acts as a DOS SHELL, allowing the
easy and convenient entry of commands. This DOS SHELL is designed to
provide an improved user interface with DOS since DOS can be slow,
cumbersome and sometimes difficult to use. DoList gives you the
editing power of a word processor when typing your commands at the
command line. Using the up arrow allows you to recall previously
executed commands.
DoList also allows you to execute commands on a LIST of files. Filenames
can be in a text file or can come from the standard DOS pipes.
DOLIST SHELL MODE: DOLIST SHELL MODE: DOLIST SHELL MODE:
To put DoList in the shell mode, type:
DOLIST <cmd> ;the <cmd> is optional.
DoList then produces a prompt and awaits your commands. Instead of the
crippled line editor that DOS provides, you now have a powerful word
processor like line editor. Left and Right Arrows move you back and
forth. INS toggles you between insert and overwrite modes. HOME takes
you to the beginning of the line, END takes you to the end. The ESC key
deletes the line. Also, the line editor responds to the standard
WORDSTAR command set.
By using the UP and DOWN arrows DoList allows you to scroll back the
last 40 or so commands. This allows you to Re-Execute commands that you
already have used. DoList also remembers what directories that you have
been to. By pressing the TAB key, DoList scrolls back to directories you
have previously visited.
DoList SHELL Mode Editing Commands:
Computer Tyme DOS ToolBox Users Manual Page 44
_______________________________________________________________
Left Arrow .......... Left one Character
Right Arrow ......... Right one Character
Ctrl Left Arrow ..... Left one Word
Ctrl Right Arrow .... Right one Word
Home ................ Beginning of Line
End ................. End of Line
Ins ................. Toggle Insert On/Off
BackSpace ........... Delete Character Left
Del ................. Delete Character Right
Ctrl Del ............ Delete Word
Esc ................. Delete Line
Up Arrow ............ Select Previous Command Line
Down Arrow .......... Select Next Command Line
Tab ................. Select Last Accessed SubDirectory
Shift-Tab ........... Reverse of TAB
Alt-Tab ............. Remove Directory from Scroll List
When you type a command in the SHELL mode, DoList first tests to see if
it is an internal DoList command. If not, it looks for *.COM, *.EXE
*.BAT files to execute. If this fails, DoList attempts to see if it is a
directory name. If it is, DoList changes directories. Otherwise DoList
will load COMMAND.COM and execute the command line.
With DoList, you can change directories by just typing the directory
name. The CD is not necessary unless there is an executable program with
the same name as the directory. Typing the "-" command or ".." changes
to the parent directory. A "\" jumps you to the root directory.
When DoList starts up it looks for several Dos ToolBox utilities to
enhance its features. If it finds them DoList becomes more powerful.
These utilities include PICK DIRECTORY, PIPEDIR, and MARXMENU.
If you have PICK DIRECTORY on your system, whenever you try to change to
a directory that isn't there, DoList will load Pick Directory and will
let you change directories with a partail name match.
The RD or remove directory command is capable of removing a directory
with files in it. Both RD and MD update the pick list that Pick
Directory uses. The DEL command supports multiple wild cards.
CD FONT might change to C:\WINDOWS\FONTS
Since DoList is loading PipeDir to delete files, several PipeDir
switches work with the DEL command.
DEL/H Includes hidden and system files.
DEL/Q Asks before deleting each file.
DEL *.BAK *.BWS Deletes all the BAK and BWS files.
DEL *.BAK/S Deletes all BAK files and in subdirectories.
Computer Tyme DOS ToolBox Users Manual Page 45
_______________________________________________________________
DoList can execute more than one command on the same command line. This
is done by separating the commands with a double bar. ||
Examples:
Free C:||Free D:||Free E:
Format A:||Sys A:||Copy Command.com A:
INTERNAL DOLIST COMMANDS: INTERNAL DOLIST COMMANDS: INTERNAL DOLIST COMMANDS:
DoList has several internal commands that can be executed from the
command line. These commands all start with the '@' symbol.
@RC ON/OFF
@Trace ON/OFF
@Path
DoList can display MS-DOS exit return codes. This feature is controlled
by typing "@RC ON/OFF". If a subprogram terminates with anything other
than a return code of zero, DoList displays it. DoList will also display
if the program was terminated by a Ctrl-Break or if the program remains
memory resident.
The @Trace command will display how DoList interprets the command line.
This will show you the whole path and file that DoList actually loads
when you type a command.
The @Path command lets you edit your path environment variable using
DoList's line editor.
When DoList loads, it looks for a configuration file called DOLIST.CFG.
This file is a text file that allows you to customize DoList. It also
contains instructions and examples. It allows you to set up programmable
function keys. These programmable keys allow you to make any unused
function key or Alt key into any command.
Examples:
AKey F9 DM ;programs the F9 key to run DM
AKey SF8 DEL *.BAK ;programs the Shift-F8 key to delete the BAK files
BKey AF5 DIR ;programs the Alt-F5 key to run DIR
Note: The AKey command forces an Enter at the end. The BKey command
forces a space at the end. Thus the BKey command allow you to type in
additional parameters.
Computer Tyme DOS ToolBox Users Manual Page 46
_______________________________________________________________
DOLIST IN LIST MODE: DOLIST IN LIST MODE: DOLIST IN LIST MODE:
Did you ever want to execute a program on a LIST of files? DoList will
execute a command line and substitute text from the standard input
device in the command line. Suppose you had a file name BAK.LST that
contained the following list of files:
NOTES.BAK
JOBS.BAK
AUTOEXEC.BAK
CONFIG.BAK
If you want to delete all the files in the list you type:
DOLIST DEL @L < BAK.LST or TYPE BAK.LST|DOLIST DEL @L
DoList will then execute the following commands:
DEL NOTES.BAK
DEL JOBS.BAK
DEL AUTOEXEC.BAK
DEL CONFIG.BAK
DoList reads each line from the standard input device and executes the
command for each line read. The @L causes DoList to insert the next
input line into the command. Thus the command DEL @L is executed for
each line from the standard input file which in this case is BAK.LST.
Suppose you want to copy all your .BAT files on you hard disk to a
floppy. This can be done by typing:
WHEREIS *.BAT|DOLIST COPY @L A:
Adding @T to the command (WHEREIS *.BAT|DOLIST COPY @L A: @T) will cause
DoList to type the commands instead of executing them. This output can
be redirected into a file for later execution.
Summary of DoList Commands for LIST mode:
@L ;substitute next input line
@1 .. @9 ;substitute field 1 thru 9
@T ;output commands as text instead of executing them
@Q ;query mode, displays command and asks for confirmation
@[ ;substitutes < in command line
@] ;substitutes > in command line
@]] ;substitutes >> in command line
@! ;substitutes | in command line
{} ;commands in {braces} are not interpreted but passed as text
In addition to the @L command which substitutes the whole line, DOLIST
can look at the lines as fields that can be substituted individually.
The individual fields are substituted by @1 thru @9. In the text line:
Computer Tyme DOS ToolBox Users Manual Page 47
_______________________________________________________________
456,NOTES.TXT "Marc Perkel"
@1 = 456
@2 = NOTES.TXT
@3 = Marc Perkel
The rule is that commas and spaces are delimiters unless you start with
a quote. If you start with a quote, the next quote is the delimiter.
If you don't want DoList to actually execute the commands, the @T
command will cause DoList to output the text that it would have
executed. This text can be redirected to a BAT file for later execution.
The @Q command makes DoList ask before executing each command line. This
allows you to skip the command or abort DoList.
Example:
PIPEDIR *.BAT >BAT.LST
Creates BAT.LST with list of all *.BAT files.
DOLIST COPY @IBAT.LST @L@T A: @OTEST.BAT
Reads each line of BAT.LST and creates the command COPY <line> A:
and writes these commands to a file named TEST.BAT.
Using braces '{}' suspends interpretation of @ commands allowing the @
to be part of the command. The outermost pair of braces are removed from
the command. This is useful when using DoList recursively. That means
using DoList to run DoList.
When a command line is presented to DOS, the redirection and piping
commands, < > | are interpreted and removed. In order to pass these
commands to a program that DoList can run, we must use other codes that
DOS won't remove. The @[ is translated into <, the @] is translated into
>, the @]] is translated into >> and the @! is translated into |.
Using DoList Recursively:
Lets say we have a file named X.LST that contains the lines:
1
2
3
And a file named Y.LST that contains the lines:
A
B
C
The following command produces the following results:
Computer Tyme DOS ToolBox Users Manual Page 48
_______________________________________________________________
DOLIST DOLIST @L{@L@T}@[x.lst <y.lst
A1
A2
A3
B1
B2
B3
C1
C2
C3
In this example, the outer DoList causes the inner DoList to be executed
three times. It executes the lines:
DOLIST A@l@t<x.lst
DOLIST B@l@t<x.lst
DOLIST C@l@t<x.lst
Notice that the outer DoList caused the first @L to be translated into
A,B,C from Y.LST and that @[x.lst was translated into <x.lst. Also note
that the braces {} were removed but the interpretation of what was
inside the braces is preserved for the inner DoList.
D.EXE D.EXE D.EXE
D is Marc Perkel's sweet little directory program. It allows you to
quickly and easilly list your directory in a variety of different ways.
Usage:
D <path\mask, (path\mask ...)> /E/D/S/U/B/I/R/A/L/W/O/P/F/+/-/1/2/3/4/5/6
/E Sort by Ext /D Sort by Date
/S Sort by Size /U Unsorted
/B Sort Backwards /I Identify Directory
/R Programs that can Run /A Files with Archive Set
/L Long Display, no Pause /W Wait for Keypress at End
/O Use Standard Output Device /P Output to Printer
/+DATE Files after Date /-DATE Files before Date
/F File Names Only
/1/2/3/4/5/6 Controls Number of Columns and Information Displayed
Normal sort is subdirectories first, then hidden and system files, then
by name alphabetically. Subdirectories, hidden and system files are
displayed in lower case. Files with hidden, system, or read only
attributes have an * next to them.
The display is a vertical sorted display with the width automatically
adjusting by the number of files. Page break is automatically adjusted
for output to different devices.
Computer Tyme DOS ToolBox Users Manual Page 49
_______________________________________________________________
Default options are sort by name, 4 columns, direct video with color.
The /R option shows files that can run. (.EXE, .COM, .BAT)
The /6 give you a 6 column display of names only. /5 shows just names
with and "*" next to the read-only, system, and hidden files. /4 shows
names and file size in K. /3 shows names and file size in bytes. /2
shows file size in bytes and date and time. /1 shows all of the above
and file attributes.
The /I option will cause the directory name to be displayed at the top
of the display:
*-*>> Directory of: C:\TURBO5\*.COM
The /O option sends output to the standard output handle instead of
directly to screen memory. You would use this option if you are running
this program over a modem, or if you're using a color card with a
composite monitor. The /O strips all color.
Output redirection is automatically detected and output is sent to the
DOS standard output handle, (/O) and no pause, (/L) is automatically
selected. Using /O will allow this program to work correctly over a
modem.
Default options can be set using the Environment Strings. SET D.EXE=/O/I
selects Standard Output and Identify Directory.
This program will handle up to 16000 files in a single directory. More
than one filespec can be specified.
D *.PAS *.INC
Will list all the files that end with with the extension of either .PAS
or .INC.
D does not have a multiple subdirectory mode. You can get the same
effect as if it did using DoList and Whereis. Suppose you want a list of
everything on your hard disk.
WHEREIS/T|DOLIST D @L /I/1 >DIRLIST
Whereis/T lists all subdirectories on the current drive. This list is
piped into DoList which executes D on each of the directories. Output is
sent to DIRLIST, a text file, for later printing or editing.
Computer Tyme DOS ToolBox Users Manual Page 50
_______________________________________________________________
FIND.EXE FIND.EXE FIND.EXE
Find replaces the FIND utility that comes with DOS. This find utility is
much more versatile.
Usage: FIND "String" <File File File> /V/C/N/L/P/I
/V Displays all lines that do not contain String.
/C Counts lines that contain String.
/N Adds line numbers to output.
/L List only names of files that contain String.
/I Ignore Case.
/P Pauses display every 24 lines.
SORT.EXE SORT.EXE SORT.EXE
SORT is just like DOS SORT except that it is only limited by memory size
instead of 64k and it is 100 times faster. SORT also has a /I option to
ignore case and will accept optional file names on the command line for
input and output.
Usage SORT <file> <file> /R/I/+N
Optional filenames for input and output files.
/R Reverse Sort.
/+N Start sorting with column N.
/I Ignore Case.
MORE.EXE MORE.EXE MORE.EXE
MORE is just like DOS MORE except a lot slicker. It erases its prompts
and gives you a pause at the end of the text stream. Pressing the space
bar advances a page at a time and pressing the return key advances a
line at a time.
Usage: DIR|SORT|MORE or TYPE DOLIST.DOC|MORE
Computer Tyme DOS ToolBox Users Manual Page 51
_______________________________________________________________
FREE.EXE FREE.EXE FREE.EXE
FREE shows free disk space, DOS memory, EMS memory, EXT, memory, and
Environment space.
Usage FREE <drive>
Total Disk Space: 126,464,000
Used Disk Space: 92,258,304 73.0%
Free Disk Space: 34,205,696 27.0%
Cluster Size: 4096 Sector Size: 512
Total DOS Memory: 655,360 bytes
Free DOS Memory: 620,096 bytes
Total EMS Memory: 3,653,632 bytes
Free EMS Memory: 2,998,272 bytes
Total ENV Space: 400 bytes
Free ENV Space: 149 bytes
FIXPATH.EXE FIXPATH.EXE FIXPATH.EXE
This program reads your path environment variable and checks to verify
that all referenced directories actually exist. Any directory that
doesn't exist, or is inaccessable is removed from the path.
This program is particularly handy after logging off a network to avoid
DOS errors.
If more than one command processor is in memory, FixPath will affect
only the last one.
Usage: FIXPATH
FORK.EXE FORK.EXE FORK.EXE
This program is used in DOS piping commands to either display what is
going through the pipe or to capture what is going through the pipe to a
file. Text going through the pipe may be routed to two command lines.
Usage: |FORK| or |FORK <filename>| or |FORK /<cmd>|
Optional filename will capture text to a file.
Examples:
DIR|FORK|SORT
DIR|FORK UNSORT.TXT|SORT >SORT.TXT
DIR|FORK /MORE|SORT|MORE
Computer Tyme DOS ToolBox Users Manual Page 52
_______________________________________________________________
PIPEDIR.EXE PIPEDIR.EXE PIPEDIR.EXE
Output from PIPEDIR is suitable for piping filenames and directory names
into other applications. PIPEDIR is also handy for finding and
cataloging files on a hard disk. Using /F will give you a detailed
display. The /D and /R options are useful for deleting files and
removing directories.
Usage: PIPEDIR <filespec> [filespec ... ] /S/W/H/T/P/X/A/N/F/D/R/Q/+/-
/S includes all subdirectories below Path.
/W WHEREIS mode, assumes /S and root directory.
/H include hidden and system files.
/T gives only directory names.
/P same as /T but adds a \ to the end.
/X exclude current directory.
/A files that have been modified since last backup.
/N names only, no path.
/F full display, size, date, time, attributes.
/D deletes files.
/R remove directory, all files, and all subdirectories.
/Q ask before delete.
/+DATE all files after date.
/-DATE all files before date.
This program becomes a WHEREIS program by copying it to WHEREIS.EXE.
At the command prompt type:
COPY PIPEDIR.EXE WHEREIS.EXE
Then run it as WHEREIS.
WHEREIS.EXE WHEREIS.EXE WHEREIS.EXE
Output from WHEREIS is suitable for piping filenames and directory names
into other applications. WHEREIS is also handy for finding and
cataloging files on a hard disk. Using /F will give you a detailed
display. The /D and /R options are useful for deleting files and
removing directories.
Usage: WHEREIS <filespec> [filespec ... ] /W/H/T/P/A/N/F/D/R/Q/+/-
Computer Tyme DOS ToolBox Users Manual Page 53
_______________________________________________________________
/W PIPEDIR mode.
/H include hidden and system files.
/T gives only directory names.
/P same as /T but adds a \ to the end.
/A files that have been modified since last backup.
/N names only, no path.
/F full display, size, date, time, attributes.
/D deletes files.
/R remove directory, all files, and all subdirectories.
/Q ask before delete.
/+DATE all files after date.
/-DATE all files before date.
MOVE.EXE MOVE.EXE MOVE.EXE
Moves files to other names, subdirectories or drives.
Usage: MOVE <file> <path> /Q/O/A/R/H/C/D
WildCards are Allowed.
/Q ;Quiet mode, no messages are displayed while moving.
/O ;OverWrite existing files without asking.
/A ;Always ask before overWriting existing files.
/R ;Include Read-Only files.
/H ;Include Hidden, System, and Read-Only files.
/C ;Copy instead of move.
/D ;Delete files.
The thing that makes this MOVE program better than other move programs
is that this one is done right! It first attempts to move by renaming.
If this fails, it copies the files and then deletes the originals.
MOVE will normally overwrite existing files if the source file is newer
than the destination file unless you use the /A or /O switches.
Examples:
MOVE XYZ.DOC \SUBDIR ;Moves XYZ.DOC to subdirectory SUBDIR
MOVE XYZ.DOC D: ;Moves XYZ.DOC to D:
MOVE *.DOC \SUBDIR ;Moves all .DOC files to SUBDIR
MOVE ABC.DOC XYZ.DOC ;Renames ABC.DOC to XYZ.DOC
MOVE A:*.* /D/H ;Deletes all files on A: in root
MOVE *.DOC \SUBDIR\*.TXT ;Moves all .DOC files to SUBDIR and
changes names to .TXT
Pipes and redirection are also allowed:
TYPE MOVE.LST|MOVE C:\UTIL ;Moves all files in MOVE.LST to C:\UTIL
Computer Tyme DOS ToolBox Users Manual Page 54
_______________________________________________________________
ZDEL.EXE ZDEL.EXE ZDEL.EXE
This Program is used to delete files. It gives you more options than the
DEL command in DOS.
Usage: ZDEL <file> (<file> ...) /Q/R/H/N/S/D
/Q ;Prompts you before deleting each file.
/R ;Include Read-Only Files.
/H ;Include Hidden, System, and Read-Only Files.
/N ;Deletes files without asking for permission.
/S ;Delete files from lower subdirectories.
/D ;Delete directory and all lower directories.
Pipes are also allowed!
TYPE DEL.LST|ZDEL
The /S and /D options require PIPEDIR.EXE to run.
RAMMAP.EXE RAMMAP.EXE RAMMAP.EXE
RamMap has several functions. It displays what is in memory, and it is
able to free up some wasted memory blocks. It can also return an error
level code to a batch file to indicate what TSRs are in memory.
Usage:
RAMMAP
RAMMAP Free
RAMMAP InMem SK.COM
RAMMAP InMem MARX.BAT
When loading TSRs, each program has it's own environment space.
Generally, this is wasted memory. Running RAMMAP FREE after each TSR
load can recover this memory. It won't gain you a lot, but in some
situations, every byte counts!
The command InMem tests to see what TSRs are loaded in memory. If the
program is found, it returns errorlevel 1. Otherwise it returns
errorlevel 0. Besides finding TSRs, InMem will also find BATCH files
that are running.
Computer Tyme DOS ToolBox Users Manual Page 55
_______________________________________________________________
Blk Own Size Program Name Type Parent Program Command Line Para
---- ---- ------ ------------ ---- ----------------- -----------------
0254 0008 5968
03CA 0008 64
03CF 4448 command.com Prog 03CF command.com
04E6 64 -- free --
04EB 03CF 400 - Master - MEnv
0505 03CF 80 MARX.BAT Bat TYME
050B 03CF 112 DROPTO.BAT Bat 0500 F:\TMPFILES\$MX..
0513 07C8 208 command.com data
0521 10848 ?? Prog 03CF command.com
07C8 2368 command.com Prog 07C8 command.com
085D 07C8 400 - Master - MEnv
0877 0886 224 RAMMAP.EXE Env
0886 620448 RAMMAP.EXE Prog 07C8 command.com
INMEM.EXE INMEM.EXE INMEM.EXE
Usage:
INMEM <program>
Example:
INMEM SK.COM
InMem tests to see what TSRs or batch files are loaded in memory. If the
program is found, it returns errorlevel 1. Otherwise it returns
errorlevel 0.
KBD.EXE KBD.EXE KBD.EXE
This program is used to control several keyboard functions. It is
typically used in BATCH files. It can control the Caps Lock, Num Lock,
and Scroll Lock. It can also lock and unlock the keyboard preventing
users from interrupting programs. It can stuff up to 16 characters into
the DOS keyboard buffer or clear the keyboard buffer. It can turn the
Print Screen on and off.
KBD commands are as follows:
Computer Tyme DOS ToolBox Users Manual Page 56
_______________________________________________________________
CapsOn - Turns Caps Lock On.
CapsOff - Turns Caps Lock Off.
NumOn - Turns Num Lock On.
NumOff - Turns Num Lock Off.
ScrollOn - Turns Scroll Lock On.
ScrollOff - Turns Scroll Lock Off.
PrtScrOn - Turns Print Screen On.
PrtScrOff - Turns Print Screen Off.
Clear - Clears all Characters from the Keyboard Buffer.
Lock - Locks the Keyboard.
UnLock - Unlocks the Keyboard.
Show - Shows Keyboard Codes that can be Stuffed.
0..31 - Sets Keyboard Repeat Rate. 0 = Fastest
,0..3 - Sets Keyboard Repeat Delay. 0 = Quickest * Default = 1.
Examples:
KBD CapsOn NumOn ;Turns both the Caps Lock and Num Lock on.
KBD Clear Lock ;Clears the buffer and locks the keyboard.
KBD 6,1 ;sets repeat rate to 6 and delay to 1.
Stuffing the keyboard buffer is accomplished by putting strings in
either single or double quotes. Putting a "^" in front of a letter sends
the control character to the keyboard buffer. Putting a "$" in front
sends the keyboard value to the buffer.
There are a few key words that stuff characters into the buffer.
F1..F10, SF1..SF10, AF1..AF10, CF1..CF10
Alt-A..Alt-Z, Alt-1..Alt-0, CR, ESC, TAB, LF, FF
Examples:
KBD "Dir" CR ;Stuffs the buffer with the DIR command
and a carriage return.
KBD "Dir" ^M ;Same as above.
KBD $3B00 ;Stuffs F1 key into the buffer
KBD ALT-X F1 6 NumOn "Free" CR PrtScrOff
This stuffs AltX, F1, "Free", and a carriage return in the keyboard
buffer. It sets Num Lock to On and sets the keyboard repeat rate to 6,
and disables the Print Screen key.
Computer Tyme DOS ToolBox Users Manual Page 57
_______________________________________________________________
PARK PARK PARK
PARK allows the user to park the heads on the hard disk drive before
turning the machine off to protect the heads from getting scratched. We
suggest that you always "park" the heads before turning your machine off
as part of your daily routine. The protection is especially useful
should your computer be moved. To park the heads just type "PARK" before
turning the machine off. When you turn the machine on again it will
operate normally.
If your hard disk is equipped with self parking heads, or if you are
running a diskless workstation on a network, you need not run this
program.
BATEXIT.BAT BATEXIT.BAT BATEXIT.BAT
BatExit is the worlds smallest useful program. It is a zero k batch
file. If you put BATEXIT in your batch file, It will cause your batch
file to exit at that point.
Example:
LOTUS.BAT
---------
CD\
123
CD\MENU
BATEXIT
* This Batch file can now be commented as much as you want
* without REM statements
WORDSTAR.BAT
------------
CD\WORDSTAR
IF NOT EXIST WS.EXE BATEXIT
WS
Computer Tyme DOS ToolBox Users Manual Page 58
_______________________________________________________________
TESTIF.EXE - Batch File Utility TESTIF.EXE - Batch File Utility TESTIF.EXE - Batch File Utility
This program tests the system and returns DOS error codes that can be
used to control the execution of .BAT files.
Usage: TestIf VideoMode
Example:
TESTIF VideoMode
IF ERRORLEVEL 7 GOTO MONO
This program tests the system and returns DOS error codes that can be
used to control the execution of .BAT files. Error codes range from 0 to
255. Within this program are commands for reading system parameters and
processing them mathematically into useful error codes.
REM This checks to see if selected screen is MONO or COLOR
TESTIF VideoMode
IF ERRORLEVEL 7 GOTO MONO
:COLOR
....
....
GOTO END
:MONO
....
....
:END
VideoMode is a Testif command that returns the current video mode. If
the current mode is MONO then VideoMode returns a 7.
With this command, if you have both MONO and COLOR screens on your
computer, and you want to set up a .BAT file to bring up a piece of
software that is installed different for mono and COLOR, Testif makes it
easy.
Testif has the capability to test results to see if a command equals a
value.
TESTIF VideoMode = 7
Returns error code 1 if true and 0 if not true. A 1 is always returned
to indicate TRUE and 0 is returned to indicate FALSE. Operators include
=, [], [, ], [=, ]=. Note the square brackets replace the normal greater
than and less than symbols. That is becuase MS-DOS filters these
characters and therefore can't be used.
TESTIF (Year = 88) and (Month = May)
Computer Tyme DOS ToolBox Users Manual Page 59
_______________________________________________________________
Testif supports all logical operators such as AND, OR, XOR, NOT.
Multiple conditions can be used. Year returns the year part of the
system date. Month returns the month part. May is a constant equal to 5.
The error code result will be 1 for true or 0 for false.
TESTIF MemSize / 10
MemSize returns the total memory size in K. Since this number is usually
larger than 255, (the maximum error code), we devide by 10. On a 640k
machine, the return code is 64. Notice that division is supported.
Testif supports the mathematical operators +, -, *, /, MOD, SHL, SHR,
AND, OR, XOR. All numbers are processed as signed 32 bit integers. It is
up to you to keep the result between 0 and 255 for meaningful results.
TESTIF 5*(9+3)
Interpretation is from left to right. Parentheses can be used to alter
this order. The above example returns 60.
TESTIF FreeSpace(0) ] 4000000
This checks freespace on the current drive (0). Other drives can also be
checked. The result is 1 if more than 4,000,000 bytes are free.
TESTIF FileSize TESTIF.EXE / 1000
This returns the file size of TESTIF.EXE in K.
To test your formulas, start the line with an @ sign. Testif will print
the return code on the screen.
TESTIF @DosVersion
Return Code: 3
TESTIF Commands:
SUN Constant = 0
MON Constant = 1
TUE Constant = 2
WED Constant = 3
THU Constant = 4
FRI Constant = 5
SAT Constant = 6
Computer Tyme DOS ToolBox Users Manual Page 60
_______________________________________________________________
JAN Constant = 1
FEB Constant = 2
MAR Constant = 3
APR Constant = 4
MAY Constant = 5
JUN Constant = 6
JUL Constant = 7
AUG Constant = 8
SEP Constant = 9
OCT Constant = 10
NOV Constant = 11
DEC Constant = 12
MONO Constant = 7
CO80 Constant = 3
BW80 Constant = 2
CO40 Constant = 1
BW40 Constant = 0
VideoMode Returns Current Video Mode
VideoPage Returns Current Video Page
ScreenWidth Returns Current Screen Width
Year Returns System Year (88=1988)
Month Returns System Month
Day Returns System Day
DayOfWeek Returns System Day of week (0=SUN)
Hour Returns System Hour
Minute Returns System Minute
Second Returns System Second
WriteVerify Returns if Write Verify is on
DosVersion Returns Dos Version Number
MinorDosVersion Returns Minor Dos Version Number
CurrentDrive Returns Current Drive Number (A: = 0)
Drives Returns Number of Drives
Floppies Returns Number of Floppy Drives
SerialPorts Returns Number of Serial Ports
ParallelPorts Returns Number of Parallel Ports
CapsLock Tells if Caps Lock is on (1=True)
NumLock Tells if Num Lock is on (0=False)
ScrollLock Tells if Scroll Lock is on
MemSize Returns Total Memory Size in K
Random Returns a Random Number from 0 to 255.
SectorsPerCluster(n) Returns Number of Sectors per Cluster (0=Current Drive)
BytesPerSector(n) Returns Number of Bytes per Sector (1=A:)
FreeClusters(n) Returns Number of Free Clusters (2=B:)
TotalClusters(n) Returns Total Number of Clusters (3=C:)
FreeSpace(n) Returns Free Space in Bytes (4=D:)
TotalSpace(n) Returns Total Space in Bytes
Exist <FileName> Tells if File Exists
FileSize <FileName> Returns File Size in Bytes
FileAttr <FileName> Returns File Attribute
FileDate <FileName> Returns Date and Time as 32 bit Number
Computer Tyme DOS ToolBox Users Manual Page 61
_______________________________________________________________
Mem(A:B) Returns Byte at A:B
MemW(A:B) Returns Word at A:B
Port(A) Returns Byte at Part A
= True if A = B
[] True if A <> B
[ True if A < B
] True if A > B
[= True if A <= B
]= True if A >= B
+ Returns A + B
- Returns A - B
* Returns A * B
/ Returns A / B
MOD Returns A mod B
AND Returns A and B
OR Returns A or B
XOR Returns A xor B
SHL Returns A shl B (Shift Left)
SHR Returns A shr B (Shift Right)
NOT Returns not A
VERSION.EXE VERSION.EXE VERSION.EXE
This program allows you to fake any DOS version number so that you can
avoid the "Incorrect DOS Version" error.
Usage VERSION 3.3 <program> <tail>
EXAMPLE: VERSION 3.3 C:\RESTORE A: C:
TEDIT TEDIT TEDIT
TEdit is a general purpose full screen editor. It is used to create and
edit text files and batch files. It is not a word processor but it is
powerful enough to write letters. The main thing you need to know
about TEdit that will help you more than anything else is that F1 is
help and F10 is the Pull Down Menu. TEdit is not a Computer Tyme
product but is licensed to Computer Tyme by Semware Inc. TEdit is a
simple version of QEdit Advanced. If you like TEdit but want more, you
may want to get QEdit. See enclosed flyer.
You can enter TEdit by just typing TEDIT or you can type TEDIT
<filename>. If you select a file that is in the current subdirectory,
TEdit will edit that file. If the file is not in the current
subdirectory, you must type in the path, for example: C:\WS\BOB.DOC.
If you select a name that is not on the disk, TEdit will create a new
file.
Computer Tyme DOS ToolBox Users Manual Page 62
_______________________________________________________________
Once you have TEdit up on your screen just use the arrow keys to move
around. TEdit also uses the WORDSTAR commands, so if you know WORDSTAR,
you know TEdit. The Home key moves you to the beginning of the line. The
End key takes you to the end. Ctrl-Home takes you to the beginning of
the file, Ctrl-End takes you to the end of the file.
STATUS LINE STATUS LINE STATUS LINE
TEdit has a highlighted bar at the top of the screen. This is the status
line. The L (number) and C (number) show you the line and column number
you are on. To the right you will see the letters IAW. You may not see
all three of these letters. The I indicates you are in the insert mode.
The A indicates you are in the auto-indent mode. The W indicates you
are in the word wrap mode.
Press the Ins key on your keyboard several times and you will see the I
appear and disappear. This indicates that the insert mode is being
switched on and off. The next thing on the status line is the filename
you are editing. If there is an '*' next to it, it means that the file
has been changed since the last time it was saved.
MAIN PULL DOWN MENU MAIN PULL DOWN MENU MAIN PULL DOWN MENU
After the file is displayed, pressing the F10 key turns on the
pull-down menu system. You can select one of the items by moving the
bar with the arrow keys and pressing ENTER or by pressing the first
letter of your selection. Once you've selected a main topic then a
vertical pull down menu will appear. You then can move up and down
with your arrow keys or just press the first letter of the selection
you want. Press ESC to abort command.
QUICK KEYS QUICK KEYS QUICK KEYS
For quick key alternatives to the following pull down menu commands
refer to F1 help.
FILE FILE FILE
This is the first option on the pull down menu. Choosing File will
cause the program to save the current document and exit to TEdit's
opening screen. Save will save current document. Quitfile will exit to
TEdit's opening screen without saving. Change name brings up a
rectangular box. Type in new filename at cursor. Be sure to include
extension if you want one.
Computer Tyme DOS ToolBox Users Manual Page 63
_______________________________________________________________
BLOCK BLOCK BLOCK
TEdit has the ability to copy, move or delete blocks of text. Before
this can be done the block has to be marked. Mark block Begin indicates
the point at which a block of text is to be marked for later copying,
moving or deleting. Position cursor at the beginning of text to be
marked as a block and then choose this option. Press ENTER. Move cursor
to end of desired block and then choose command mark block End. Press
ENTER to highlight block. To copy block and move block position cursor
at point in document where highlighted (blocked) text should be inserted
and choose the appropriate option. Delete block is self-explanatory.
Unmark removes highlighting and returns text to normal mode.
You can also mark a block by moving the cursor to the beginning of a
block and pressing F7. Then you move the cursor to the end of the block
and press F8 to highlight. Now you can delete this block by pressing
Alt-D. Or, if you want to copy the block, just move the cursor to where
you want to copy to and press Alt-C. Alt-M will move the block.
SEARCH SEARCH SEARCH
Here you are allowed to search for a word or phrase and replace it
with a different word or phrase. Choose Search and a popup menu
appears. Type the word or phrase you want to search for and press
ENTER. Replace allows you to search for a word or phrase and then
replace it. The popup menu asks for the text you want to search for
and then asks you for the replacement text.
The following search options will appear: "ignore" means TEdit will find
matches on both upper and lower case; "words" means search for whole
words only; "backward" begins to search from the point of cursor,
backwards toward beginning of document and "no ask" will search and
replace without asking you each time whether you want to replace a word
or not. Again repeats the previous search or search and replace.
F5 is an alternate means of search and replace. Normally the search is
forward from where you are. Selecting B allows you to search backwards.
When a match is found, Ctrl-L will allow you to continue the search for
the next match.
Pressing F6 will start search and replace. It starts just like search
but then asks you for text to substitute. Then it gives you a few more
options. The N option tells TEdit to replace all of the matches in the
file from where you are until the end.
Computer Tyme DOS ToolBox Users Manual Page 64
_______________________________________________________________
PRINT PRINT PRINT
Print allows you to print text. Print All prints the entire contents of
current file. Print Block Prints entire contents of a marked block. The
marked block must be in the current file. Use Block marking command for
marking block. send Formfeed allows you to force a pagebreak. Simply
insert a formfeed character in the text at beginning and end of text
needing to be printed on a separate page. The formfeed character is
"CTRL P" followed by "CTRL L". Set Left margin specifies the number of
blank spaces to be used as a left margin. Set Page size specifies the
number of lines to be printed on each page.
EDITING EDITING EDITING
Add line is simple to use and self-explanatory as is Delete line; delete
to End of line; Insert line; Join line; Split line and Undelete line
OTHER OTHER OTHER
Other represents a variety of other options available in TEdit. Set
Autoindent OFF If auto-indent mode is on, (indicated by the A on the
status line), when you go to the next line it will begin just under the
beginning of the previous line rather than all the way to the left. To
set auto-indent on or off toggle the appropriate menu selection "Other"
on the main menu bar.
Set Insert OFF When you type you can select whether you are going to
type over what's there or insert new text. This is controlled by the
insert mode. The insert mode can be turned on and off by the Ins key on
the keyboard or toggled on or off from the "Other" menu. The I on the
status line indicates insert mode on.
Set Wordwrap On means that when you get close to the right side of the
screen while you are typing, TEdit will automatically wrap to the next
line. This is handy for writing letters or documentation files. You
would normally turn it off for programming. The column where word wrap
occurs is set by the right margin command. Toggle this menu option on
or off.
Set Right margin sets the right margin for word-wrap and paragraph
reformatting.
QUIT QUIT QUIT
Quit Terminates the program. Save-eXit saves the current document and
exits to DOS. Quit brings up option of saving and quitting or quitting
without saving.
Computer Tyme DOS ToolBox Users Manual Page 65
_______________________________________________________________
SAVING YOUR WORK SAVING YOUR WORK SAVING YOUR WORK
As you type you should press F2 periodically to save your work to disk.
This way, if power should fail, your work is saved. The F4 key will save
your work and exit TEdit.
TSR MANAGEMENT UTILITIES TSR MANAGEMENT UTILITIES TSR MANAGEMENT UTILITIES
The TSR Utilities are copyright (c) 1986,1987,1989 by Kim Kokkonen. All
Rights Reserved.
The TSR Utilities were written by Kim Kokkonen, with thanks to Neil
Rubenking for the original idea behind MARK and RELEASE. Special thanks
to Richard Wilson and Barry Simon at CalTech for the idea that lead to
FMARK, and for much useful correspondence about the TSR Utilities.
Marc Perkel, owner of Computer Tyme Inc., has purchased the rights to
distribute the TSR utilities written by Kim Kokkonen of TurboPower
Software on a commercial basis. These programs are fully compatible with
MarxMenu and the Computer Tyme DOS ToolBox. They can be used with
MarxMenu to load and unload TSR programs under menu control.
These programs are tools for the experienced DOS user. If you are a
novice user, this is not the place to start. Get familiar with the rest
of the software packages first and then come back here. These utilities
are provided for the advanced user who needs to be able to do memory
management.
ABOUT TURBOPOWER SOFTWARE ABOUT TURBOPOWER SOFTWARE ABOUT TURBOPOWER SOFTWARE
TurboPower Software writes programmers tools mostly for Turbo Pascal
programmers. These tools include B-TREE FILER, TURBO ANALYST, TURBO
PROFESSIONAL , and OBJECT PROFESSIONAL. I personally use these
products and can say with certainty that anyone who is doing any
serious work with Turbo Pascal should buy these packages. My software
uses them extensively and it wouldn't be the same without it.
You can reach Kim Kokkonen at:
TurboPower Software
P.O. Box 66747
Scotts Valley, CA 95066-0747
408-438-8608 (voice only, Monday-Friday 9AM-5PM)
Compuserve: 76004,2611
Turbo Power Software now has it's own area on Compuserve.
You can get there by typing GO PCVENB at any prompt.
Computer Tyme DOS ToolBox Users Manual Page 66
_______________________________________________________________
INTRODUCTION INTRODUCTION INTRODUCTION
The TSR Utilities are a collection of programs useful for managing DOS
memory, particularly for managing memory-resident programs, also known
as TSR's. TSR stands for "Terminate and Stay Resident". The most popular
use of these TSR utilities is for removing TSR's from memory without
rebooting the PC. There are many other uses, however, especially if you
are a software developer.
The TSR Utilities have grown to include 11 programs. Here's a quick
overview of each one:
MARK marks a position in memory above which TSR's can be
released.
RELEASE removes TSR's from memory.
FMARK performs the same function as MARK but uses less memory.
MARKNET like MARK, but saves a more complete picture of system
status.
RELNET removes TSR's marked with MARKNET.
WATCH a TSR itself, it keeps records of other TSR's.
DISABLE disables or reactivates TSR's, leaving them in memory.
RAMFREE shows how much RAM memory is available.
MAPMEM shows what memory resident programs are loaded.
DEVICE shows what device drivers are loaded.
EATMEM uses up memory for controlled program testing.
These programs are described in detail in the following sections. If you
haven't used them before, be sure to read the documentation: All of the
programs are command line driven, and unexpected events may occur if you
just start typing the program names at the DOS command line.
The documentation for version 2.8 has been revised substantially. If
you're familiar with previous versions of the TSR Utilities, the most
important change in v2.8 is the addition of MARKNET and RELNET. These
new programs allow marking and releasing the Novell NetWare shell, as
well as other "problem TSR's" that could not be released successfully in
previous versions.
Computer Tyme DOS ToolBox Users Manual Page 67
_______________________________________________________________
MARK, FMARK, and RELEASE MARK, FMARK, and RELEASE MARK, FMARK, and RELEASE
MARK.COM and RELEASE.EXE are used to remove TSR's from memory, without
requiring a system reboot. In their simplest form, MARK and RELEASE are
used as follows:
1. Run MARK before installing your TSR(s). This marks the current
position in memory and stores information that RELEASE will later need
to restore the system. A common place to call MARK is in your
AUTOEXEC.BAT file.
2. Install whatever TSR's you want, using the normal method for each
TSR.
3. To remove those TSR's from memory, run RELEASE. This will release all
of the memory above (and including) the last MARK, and will restore the
system to the state at the time the MARK was made.
There are a number of variations of this simple method. First, MARKs can
be stacked in memory, as shown in the following hypothetical batch file:
MARK
TSR1
MARK
TSR2
MARK
TSR3
Each call to RELEASE releases memory above and including the last MARK.
In this example, the first call to RELEASE would remove TSR3 and the
last MARK from memory, the second call would remove TSR2 and its MARK,
and so on.
MARK and RELEASE may be called using a command line parameter. The
parameter specifies a "mark name" and allows releasing TSR's to a
specific point in memory. Consider the following example:
MARK TSR1
TSR1
MARK TSR2
TSR2
MARK TSR3
TSR3
This loads the three TSR's just as in the previous example. However, if
RELEASE were called like this:
RELEASE TSR2
Computer Tyme DOS ToolBox Users Manual Page 68
_______________________________________________________________
Then both TSR2 and TSR3 would be removed from memory. Note that the use
of such a name does not allow just a single layer of TSR's to be removed
(just TSR2, for example). RELEASE always removes all TSR's including and
beyond the one named.
A mark name is any string up to 126 characters long. The name may not
include white space (blanks or tabs). Case (upper or lower) is not
significant when matching mark names.
When named marks are used as in this example, calling RELEASE without
specifying a mark name will still remove the last TSR from memory.
Assuming that TSR1, TSR2, and TSR3 are still in memory, typing just
RELEASE would remove TSR3 and the last mark. It is possible to change
this behavior by using "protected marks", which can be released only by
explicitly specifying their names. A protected mark is placed by giving
it a name that starts with an exclamation point, '!'. Consider the
following:
MARK TSR1
TSR1
MARK TSR2
TSR2
MARK !TSR3
TSR3
Here !TSR3 specifies a protected mark. Typing just RELEASE would produce
an error message "No matching marker found, or protected marker
encountered". The same error would occur after entering the command
RELEASE TSR2. When this error occurs, RELEASE does not remove any TSR's
from memory.
The only way to remove TSR3 in this case is by entering:
RELEASE !TSR3
Each time a MARK is placed in memory, it consumes about 1600 bytes of
RAM space, which is used to store a copy of the system interrupt vector
table and other information with which RELEASE can later restore the
system. Although 1600 bytes isn't very much, we can reduce this memory
usage by storing the information in a disk file rather than in memory.
FMARK.COM is a variation on MARK that does just that. You can call FMARK
at any time that you would call MARK. FMARK uses only about 150 bytes of
memory.
All calls to FMARK must include a command line parameter to specify the
name of the file:
FMARK [d:][directory]filename
Computer Tyme DOS ToolBox Users Manual Page 69
_______________________________________________________________
You should generally specify a complete pathname for the mark file. When
you later call RELEASE, you must give it the identical pathname,
regardless of what the current directory happens to be at the time. For
example, if you specified the following file mark:
FMARK C:\TEST\TEST.MRK
then the following calls to RELEASE would generate an error:
RELEASE TEST.MRK
RELEASE C:TEST.MRK
Even if the current directory on drive C: was \TEST. The only way
to call RELEASE is with
RELEASE C:\TEST\TEST.MRK
or
release c:\test\test.mrk
RELEASE can use either type of mark: in-memory or on-disk. Note that
RELEASE treats marks placed with FMARK just like protected marks. That
is, they can be released only by explicitly naming them. (This is a
change in behavior from versions of RELEASE prior to 2.8. The change is
especially important when net marks, described below, are also in use.)
Consider the following example:
MARK
TSR1
FMARK C:\MARKS\TSR2.MRK
TSR2
Typing just RELEASE in this situation generates the warning message "No
matching marker found, or protected marker encountered", because the
file mark is treated like a protected mark.
TSR2 can be removed from memory by entering
RELEASE C:\MARKS\TSR2.MRK
RELEASE deletes the mark file when it has finished.
RELEASE has several command line options to modify its behavior. The
following table lists the options, which must start with a slash, '/'.
/E do NOT access EMS memory.
/K release memory, but keep the mark in place.
/S chars stuff string (<16 chars) into keyboard buffer on exit.
/? write this help screen.
None of the options is required for normal use of RELEASE.
Computer Tyme DOS ToolBox Users Manual Page 70
_______________________________________________________________
/E is made available for systems running early, buggy EMS (expanded
memory) drivers which don't correctly implement all of the EMS 3.2
system calls. Don't use it unless you have an EMS-related problem during
or after running RELEASE.
/K is useful when you will be releasing and reloading a TSR repeatedly.
With it, you avoid the need to replace the mark each time the TSR is
released. Using /K in combination with a file mark also prevents RELEASE
from deleting the mark file.
/S followed by at least one space and then a short string (15 characters
or fewer) tells RELEASE to stuff this string into the keyboard buffer
just before exiting. RELEASE automatically adds a carriage return to the
end of the string.
To explain why the /S option is important, we must digress a moment.
Let's assume that you normally keep SideKick loaded, but that you must
unload it in order to have enough memory free to run Lotus 1-2-3. It
would seem reasonable to write a little batch file like this:
RELEASE SK
LOTUS
MARK SK
SK
This would remove the previously loaded SideKick from memory, run Lotus,
and then load SideKick again. Unfortunately, this won't work!
The reason is complicated to explain. It must suffice here to say that
DOS batch files trap memory, and the memory freed by a call to RELEASE
does not truly become available until the current batch file ends.
Now perhaps the need for the /S option becomes clear. We can split the
previous batch file into two:
batch1:
RELEASE SK /S BATCH2
batch2:
LOTUS
MARK SK
SK
The first batch file releases the memory and stuffs the characters
'BATCH2<Enter>' into the keyboard buffer. When the batch file ends, the
released memory becomes available. DOS automatically reads the
keystrokes waiting in the buffer and starts up the second batch file,
which runs Lotus and later reloads SideKick.
Computer Tyme DOS ToolBox Users Manual Page 71
_______________________________________________________________
To keep things simple, the /S option pokes the specified keystrokes
directly into the system keyboard buffer. As a result, the number of
keystrokes is limited to 15 (not counting the <Enter> key, which RELEASE
adds automatically). This always allows enough keys to start another
batch file, however, and the new batch file can take over from there.
RELEASE detects when it is releasing memory within a batch file. It
writes a warning message to that effect, but continues processing anyway
under the assumption that the batch file is about to end. You can ignore
the warning if you've already taken account of DOS's memory management
behavior within batch files.
MARK and RELEASE are capable of removing many, but not all, TSR's from
memory. The TSR's that cannot be released fall into two categories:
those that cannot be released without specific internal knowledge of the
TSR, and those that can be released by storing additional general
information about the system.
The most common examples of TSR's that we can't be released without
internal knowledge are those that cooperate with other TSR's in memory.
Examples include Microsoft's MOUSE driver and its associated MENU
program; and the program CED with its "user-installed commands" such as
KEYIN, HS, RAW, and others. These programs can be released, but only if
all the cooperating partners are released at the same time. CED is
well-behaved in that it provides a built-in command (KILL) to release
its partners. MOUSE is not so flexible, though.
Other TSR's modify well-defined areas of DOS memory that MARK and FMARK
simply don't record. Examples of such TSR's include the Novell NetWare
workstation shell and certain DOS utilities like MODE and SHARE. To deal
with these programs we've written the MARKNET and RELNET utilities,
described in the next section, which store just about every imaginable
DOS data area, including some that are undocumented by MicroSoft. If you
have trouble removing a particular TSR with MARK/RELEASE, try using
MARKNET/RELNET instead.
WARNING: you should not use either RELEASE or RELNET to try to release
most disk cacheing programs. If you do so, part of the information that
should be stored on disk will never make it, and you may end up with a
corrupted disk as a result. If you know that the disk cache uses a
"write-through" algorithm (which guarantees that all writes immediately
go to disk), or if the disk cache has a "flush the cache" command, then
it may be safe to release the cache.
WARNING: you cannot release the DOS 3.3 FASTOPEN or APPEND TSR's. These
TSR's patch internal DOS data areas that cannot be reliably located by
even MARKNET and RELNET.
Computer Tyme DOS ToolBox Users Manual Page 72
_______________________________________________________________
MARKNET and RELNET MARKNET and RELNET MARKNET and RELNET
Use of these utilities is very similar to that described in the
preceding section. MARKNET is analogous to FMARK, and RELNET is like
RELEASE. Because MARKNET stores so much information about the system, it
writes it to a disk file in order to reduce its own memory usage.
Command line syntax for MARKNET and RELNET is:
MARKNET [d:][directory]filename
RELNET [d:][directory]filename [options]
The main command line parameter to each program specifies the name of
the file where the mark information will be stored. We refer to this
file as the net mark file. A complete pathname should be specified for
the net mark file. RELNET's pathname must exactly match that passed to
MARKNET, with the exception of case.
Note that MARKNET and RELNET may be used in almost any situation where
FMARK and RELEASE are used. MARKNET saves all of the same system
information as does FMARK, but it goes further to store information such
as the device driver chain, DOS internal variable areas, DOS system file
tables, DOS environment, communications port status, and other
information. Nevertheless, MARKNET and RELNET were written primarily
because of the large demand to release the NetWare shell. We'll refer to
NetWare specifically in the following and provide an example of how to
load and release it.
The only new restriction for using MARKNET is that the system must be
running DOS version 3.0 or later. MARKNET depends on the format of
certain internal DOS data structures that were quite different in DOS
version 2.
Like FMARK, MARKNET leaves a small (144-192) byte mark in memory, and
writes a disk file to store the system status. MARKNET's file varies in
size, but is typically 3-4K bytes. The size depends on the number of
device drivers, the value of the 'FILES=' directive in CONFIG.SYS, and
other implementation details of DOS.
Do not attempt to redirect the output of MARKNET. Doing so will waste at
least one file handle that cannot be recovered later by RELNET.
Marks placed with MARK, FMARK, and MARKNET may be mixed in the same
system. RELEASE treats all marks placed with MARKNET as protected; such
marks may be released only by calling RELNET explicitly. Consider the
following example:
Computer Tyme DOS ToolBox Users Manual Page 73
_______________________________________________________________
MARK
TSR1
FMARK C:\MARKS\TSR2.MRK
TSR2
MARKNET C:\MARKS\TSR3.MRK
TSR3
Entering RELEASE by itself would generate a warning and do nothing else.
Entering RELEASE C:\MARKS\TSR2.MRK would generate the same warning. The
only way to get all three of these TSR's out of memory would be to enter
the following commands in sequence:
RELNET C:\MARKS\TSR3.MRK
RELEASE C:\MARKS\TSR2.MRK
RELEASE
RELNET has options to control how much of the system state it restores.
Several of the options match those of RELEASE; new ones are needed
because of the additional information that MARKNET stores. RELNET
accepts the following options:
/C do NOT restore the communications ports.
/E do NOT access EMS memory.
/K release memory, but keep the mark in place.
/P do NOT restore DOS environment.
/R revector 8259 interrupt controller to powerup state.
/S chars stuff string (<16 chars) into keyboard buffer on exit.
/T do NOT reset the system timer chip.
/V verbose: show each step of the restore.
/? write help screen.
None of these options is required in order to release the NetWare
workstation shell.
/C keeps RELNET from restoring the communications state of the system
(as encoded in the 8250 async chip and the 8259 programmable interrupt
controller). Because both of these chips provide readable registers,
MARKNET is able to store an accurate picture of the communications state
when the mark is stored; RELNET can restore the state to exactly what it
was. Therefore, the /C option should be needed rarely, perhaps only on
newer PS/2 models that don't use the 8250 as a communications
controller. (We haven't tested MARKNET and RELNET on a PS/2 model 50z.
Use caution if you have such a system.) Note that MARKNET stores
information only about COM1 and COM2.
/E is made available for systems running early, buggy EMS drivers that
don't correctly implement all of the EMS 3.2 system calls. Don't use it
unless you have an EMS-related problem during or after running RELNET.
Computer Tyme DOS ToolBox Users Manual Page 74
_______________________________________________________________
/K is useful when you will be releasing and reloading a TSR repeatedly.
With it, you avoid the need to replace the mark each time the TSR is
released. Using /K prevents RELNET from deleting the net mark file.
/P keeps RELNET from restoring the DOS environment, which it normally
does because NetWare modifies the DOS PATH. In some cases, other changes
to the environment should not be undone; use the /P switch only when
such changes must be preserved.
/R may be useful for unloading task-switching utilities that "revector"
the hardware interrupt controller. Use it only if it solves a problem.
/S followed by at least one space and then a short string (15 characters
or fewer) tells RELNET to stuff this string into the keyboard buffer
just before exiting. RELNET automatically adds a carriage return to the
end of the string. See the discussion of /S in the preceding section for
more details.
/T keeps RELNET from resetting the system timer chip to its default
rate, which it does by default.
/V activates additional status reporting during the release and may
provide useful information in cases when RELNET isn't working.
The following is a simplified version of a NetWare LOGIN.BAT file with
support for releasing the shell:
rem place the mark
marknet C:\NET\NETWARE.MRK
rem load the NetWare shell TSR's
ipx
net3
rem optional portions of the shell
rem netbios
rem int2f
rem switch to login drive and log in
F:
login USERNAME
The items in uppercase, at least, will need to be customized for a given
user and workstation.
NetWare could then be released with the following batch file:
rem let the server know we're leaving
z:\public\logout
rem restore the workstation
relnet C:\NET\NETWARE.MRK
Computer Tyme DOS ToolBox Users Manual Page 75
_______________________________________________________________
WATCH AND DISABLE WATCH AND DISABLE WATCH AND DISABLE
WATCH.COM is a resident program that keeps track of other memory
resident programs. As a TSR goes resident, WATCH updates a data area in
memory that contains information about what interrupt vectors were taken
over. This information can later be used by MAPMEM and DISABLE to show
more details about interrupts than normally available.
Installation of WATCH.COM is optional. All of the TSR Utilities except
DISABLE can be used whether or not WATCH is installed.
If you want to use it, WATCH.COM should be installed as the first TSR in
your AUTOEXEC.BAT file. WATCH uses about 4000 bytes of memory when it is
installed. Most of this memory holds various information about the TSR's
installed in the system -- it includes two copies of the interrupt
vector table, and a data area containing a list of the interrupt vectors
taken over by each TSR. This information is used by DISABLE to
deactivate and reactivate TSR's without removing them from memory.
With DISABLE.EXE, you can disable and re-enable specified memory
resident programs without removing them from memory. Its function is
analogous to that performed by REFEREE from Persoft, although DISABLE
has neither a fancy user interface nor an option to work from within
other programs. DISABLE can allow conflicting TSR's to coexist, and it
can let you run applications whose keystrokes conflict with those of
TSR's already loaded. DISABLE also provides a small bonus in that it can
be used to detect the presence of a particular TSR in memory, thus
allowing the design of semi-intelligent batch files.
In order to use DISABLE, you must install WATCH.COM as the first memory
resident program in your system. WATCH keeps the detailed information
about each memory resident program that DISABLE uses to later control
them.
Like the other TSR Utilities, DISABLE is operated from the command line.
You specify a single TSR by its name (if you are running DOS 3.0 or
later) or by its address as determined from a MAPMEM report (described
below). If you specify an address, immediately precede the address with
a dollar sign "$" and specify the address in hexadecimal.
The name specified for a TSR is the one reported by MAPMEM in the
"owner" column. If the owner column reports "N/A", then you must instead
specify the address from the "PSP" column.
DISABLE accepts the following command line syntax:
DISABLE TSRname|$PSPaddress [options]
Options may be preceded by either / or -. Valid options are as follows:
Computer Tyme DOS ToolBox Users Manual Page 76
_______________________________________________________________
/A reactivate the specified TSR.
/C check for the presence of the specified TSR.
/? write a help screen.
If no option is specified, DISABLE will disable the named TSR.
Examples of usage:
DISABLE SK disables SideKick
DISABLE SK /A reenables SideKick
DISABLE SK /C checks for the presence of SideKick
DISABLE $2F2E disables the TSR at address 2F2E (hex)
DISABLE sets the DOS ERRORLEVEL in order to return status information to
a batch file. It uses the following values of errorlevel:
0 success: TSR is present, was disabled, or was reenabled.
1 TSR is present, but no action was required to enable or disable it.
2 TSR is not present in memory.
254 invalid command line.
255 severe error.
WARNING: you cannot use DISABLE to deactivate SideKick Plus, whose
swapping technique is incompatible with DISABLE.
MAPMEM, RAMFREE, AND DEVICE MAPMEM, RAMFREE, AND DEVICE MAPMEM, RAMFREE, AND DEVICE
These three utilities provide status information about DOS memory usage.
They don't make active changes to the system like RELEASE and DISABLE
do.
MAPMEM.EXE displays a map of DOS memory. It shows the resident programs,
how much memory they use, and what interrupt vectors each one controls.
MAPMEM also shows information about expanded and extended memory when
available.
MAPMEM writes to the standard output -- hence, the output can be printed
or stored to a file by using DOS redirection.
Here is an example of MAPMEM output:
Computer Tyme DOS ToolBox Users Manual Page 77
_______________________________________________________________
PSP blks bytes owner command line chained vectors
----- ---- ----- -------- ------------------- -------------------
0008 1 34240 config
1228 2 3536 command
1315 2 3888 WATCH TSR WATCHER 16 21 27
140A 2 22128 CED N/A 1B 21 64
1973 1 144 N/A C:\MARK\PS.MRK
197D 2 736 PSKEY S3 09 15
19AD 2 68400 PS /B:0 /E:1 /R:0 /... 01 03 06 0D
2A62 2 1504 MARK test 00 3F
2AC2 2 10384 EATMEM 10
2D4D 2 469808 free
block bytes (Expanded Memory)
----- ------
1 1048576
free 1048576
total 2097152
(Extended Memory)
total 379240
"PSP" stands for Program Segment Prefix. This is the physical address,
specified in hexadecimal, where the program was loaded. If you're
running DOS 2.x, you'll need to use an address from this column to pass
to DISABLE.
"Blks" is the number of memory blocks DOS is using to manage the
program. This will typically be two: one for the program itself and
another for the environment that stores the program name, the DOS path,
and other environment variables.
"Bytes" is the number of bytes of memory, specified in decimal,
allocated to the program.
The "owner" column shows the name of the program that allocated the
block. An "N/A" in this column means either that the program deallocated
its environment to reduce memory usage (as shown on the fifth row of the
report) or that the system is running DOS 2.x, where the owner names are
simply not available.
"Command line" shows the command line entered when the TSR was
originally loaded. Some TSR's overwrite their command line with other
code or data in order to save memory space. MAPMEM can usually detect
this behavior and will display "N/A" in the command line column when it
does.
Computer Tyme DOS ToolBox Users Manual Page 78
_______________________________________________________________
The last column will be titled with either "chained vectors" or "hooked
vectors". When WATCH is loaded, "chained" will appear; otherwise,
"hooked" will. The numbers in this column indicate what interrupt
vectors the TSR has grabbed. Without WATCH, MAPMEM must use a heuristic
technique to identify the owner of each vector; don't be surprised if
you see some ridiculous looking vector numbers. With WATCH, MAPMEM
should report an accurate list for each TSR, and should show the
complete chain of control for each interrupt.
MAPMEM indicates disabled TSR's by displaying the word "disabled" in the
interrupt vector column of the report.
The expanded memory report shows each allocated block of expanded
memory, as well as the free and total EMS space. When extended memory is
available, MAPMEM shows just the total amount available. The extended
memory report is not highly reliable because of the lack of a
standardized method for allocating extended memory space. Some
applications that use extended memory allocate the space by making it
appear that the memory is no longer in the system.
MAPMEM shows the various types of marks so that you can examine them
prior to a releasing them. As shown in the example, MAPMEM reports a
call to MARK with the owner name "MARK", and the mark name (if any) in
the command line area. The result of a call to FMARK or MARKNET will
show "N/A" in the owner column (due to the minimal memory kept by an
FMARK), and the name of the mark file in the command line area.
MAPMEM offers the following command line options:
/V verbose report.
/? write a help screen.
The verbose report shows each individual memory block rather than just
one for each program. It also adds two new columns of information. "Mcb"
stands for Memory Control Block. This is a physical address, expressed
in hexadecimal, of the DOS data structure used for managing each block
of memory. The MCB address is typically one less than the address of the
program. "Files" reports the number of files kept open by the TSR. In
most cases this will be zero. When it is non-zero, the maximum number of
files opened by the rest of the programs (including the foreground
application) is reduced accordingly.
RAMFREE.COM is a tiny program with a single purpose: to tell you how
many bytes of memory are free for the next application. The number it
reports is the same as that reported by the DOS CHKDSK utility.
RAMFREE's advantage is that you don't need to wait for your hard disk to
be analyzed before you find out how much memory is free.
Computer Tyme DOS ToolBox Users Manual Page 79
_______________________________________________________________
DEVICE.EXE reports on device drivers installed by the CONFIG.SYS file.
It shows the memory used by DOS itself, any additional drivers installed
in CONFIG.SYS, and the space used for DOS file handles and buffers. Here
is a simple example of DEVICE output:
Address Bytes Name Hooked vectors
--------- ------ -------------- --------------
0070:0BB3 - CON
0070:0C68 - AUX
0070:0C7A - COM1
0070:0D17 - PRN
0070:0D29 - LPT1
0070:0E15 - CLOCK$
0070:0EE5 - 3 Block Units
0070:2071 - LPT2
0070:2083 - LPT3
0070:2095 - COM2
0000:2C58 37712 NUL 08 0A 0C 0D 0E 13 25 26 29
73 74 75 76 77
09A5:0000 3488 0 Block Units
0A7F:0000 18 EMMXXXX0
0A7F:0012 46 386MAX$$ 20
0A83:0000 768 1 Block Unit 19
0AB3:0000 768 1 Block Unit
0AE3:0000 18256 DOS buffers
The devices up to and including NUL are all part of DOS. DEVICE lumps
their memory usage into a single value next to the NUL device. The
memory usage associated with NUL does not include the interrupt vector
table, the BIOS data area, or the low-memory DOS data area. If you wish
to add this memory to the total, just take the hexadecimal segment of
the first driver you see (in this case CON) and multiply it by 16
decimal. When the segment is 0070 as shown, that adds 1792 bytes to the
total space for DOS.
Don't expect the sum of the DEVICE bytes to match the bytes reported by
MAPMEM in the row labeled 'config'. MAPMEM's report shows what DOS
thinks has been allocated, but that number isn't complete since some of
the memory was used before DOS was truly loaded. However, you should
find that the sum of the DEVICE bytes, plus all of MAPMEM's memory
excluding the 'config' row, equals the total normal RAM in the system.
DEVICE also lumps all of the drivers up to NUL into a single block when
it comes to reporting hooked interrupt vectors. Because WATCH can't be
installed prior to these device drivers, DEVICE must use an empirical
technique to detect which vectors each driver controls. Therefore, some
meaningless vectors may appear in the list. Any vectors that are grabbed
by another program after the driver is loaded will not appear.
Computer Tyme DOS ToolBox Users Manual Page 80
_______________________________________________________________
"Block units" typically refer to disk drives. Any drivers that appear
after the NUL device are in the order that you've entered them in
CONFIG.SYS. Drivers loaded for non-standard hard disks, like SpeedStor,
sometimes make odd entries in the DEVICE report, as shown with "0 Block
Units" above. RAM disks appear more logically: each of the "1 Block
Unit" entries above is a VDISK with the data stored in extended memory.
Devices like 386MAX may also cause odd-looking entries: 386MAX puts most
of its code in extended memory, and leaves just a bit behind in normal
memory.
DEVICE offers the following command line options:
/R raw report.
/? write a help screen.
The raw report shows more information about the device drivers, but in a
less convenient format. Here's an example, taken on the same system as
the previous report.
Starting Next Strategy Interrupt Device
Address Hdr Addr Attr Entry Pnt Entry Pnt Name
--------- --------- ---- --------- --------- --------
0000:2C58 0AB3:0000 8004 0000:14C6 0000:14CC NUL
0AB3:0000 0A83:0000 0800 0000:00A9 0000:00D4 1 Block Unit
0A83:0000 0A7F:0012 0800 0000:00A9 0000:00D4 1 Block Unit
0A7F:0012 0A7F:0000 C000 0000:0036 0000:003B 386MAX$$
0A7F:0000 09A5:0000 8000 0000:0036 0000:003B EMMXXXX0
09A5:0000 0070:0BB3 2000 0000:0012 0000:001D 0 Block Units
0070:0BB3 0070:0C68 8013 0000:00C6 0000:00D1 CON
0070:0C68 0070:0D17 8000 0000:00C6 0000:00D7 AUX
0070:0D17 0070:0E15 A040 0000:00C6 0000:00E6 PRN
0070:0E15 0070:0EE5 8008 0000:00C6 0000:010C CLOCK$
0070:0EE5 0070:0C7A 0840 0000:00C6 0000:0112 3 Block Units
0070:0C7A 0070:0D29 8000 0000:00C6 0000:00D7 COM1
0070:0D29 0070:2071 A040 0000:00C6 0000:00EC LPT1
0070:2071 0070:2083 A040 0000:00C6 0000:00F4 LPT2
0070:2083 0070:2095 A040 0000:00C6 0000:00FC LPT3
0070:2095 0070:FFFF 8000 0000:00C6 0000:00DD COM2
In this report, the drivers are listed in DOS priority order rather than
the order in which they are loaded in memory. Additional columns
describe how DOS treats each driver. Ray Duncan's book "Advanced MS-DOS"
is a good place to learn more about these details.
The DEVICE program assumes that all device drivers are loaded in the
CONFIG.SYS file. That is not the case with the NetWare shell, which
patches itself into the device driver chain. DEVICE will write a warning
message and terminate before reporting the first patched-in driver. The
raw device report will still show all of the devices even in this case.
Computer Tyme DOS ToolBox Users Manual Page 81
_______________________________________________________________
EATMEM EATMEM EATMEM
EATMEM is a small program that is useful only to software developers. It
is a TSR that consumes a specified amount of memory. Developers can use
it to simulate a system with less memory, or to create a buffer zone
between an application and programs preceding it.
The memory used by EATMEM can be freed only by using MARK and RELEASE.
Call EATMEM with a single command line parameter, specifying the
(decimal) number of KILOBYTES to eat up:
EATMEM KiloBytesToEat
EATMEM will allow you to eat up all available memory, leading to a
system crash when COMMAND.COM cannot be reloaded. Be sure to calculate
how much memory to use before calling EATMEM.
THE NETWORK SURVIVAL KIT THE NETWORK SURVIVAL KIT THE NETWORK SURVIVAL KIT
The following programs are part of the Computer Tyme Network Survival
Kit and are not part of the DOS ToolBox. They are in this manual because
this manual is shipped with the Network Survival Kit and I needed a
place to put it. If you do not have a copy of the NSK, the remaining
part of this manual does not apply to you.
XMETER.EXE XMETER.EXE XMETER.EXE
This program is used to control access to programs on a Novell network
and limit the number of users that can run a program at the same time.
Usage: XMETER <Semaphore> <MaxUsers> /O/C/U/L
Semaphore is any name you want to give a semaphore. MaxUsers is the
maximum number of users allowed to use the semaphore or the name of a
meter list file.
/O Open Semaphore.
/C Close Semaphore.
/U Return Number of Semaphore users.
/L Outputs status line for log file redirection.
Example: XMETER TEST 10 /O
This opens semaphore TEST if less than 10 users have it open, otherwise
to returns DOS ErrorLevel 1.
Example: XMETER TEST /C
This closes semaphore TEST allowing others to use it.
Example: XMETER TEST METER.LST /O/L >> USAGE.LOG
Computer Tyme DOS ToolBox Users Manual Page 82
_______________________________________________________________
This opens semaphore TEST if less than the number of users specified in
METER.LST have it open, otherwise to returns DOS ErrorLevel 1. Log
information is redirected to append log file USAGE.LOG.
XMETER is a software metering program for Novell Networks. Its simple,
uses NO RAM, and does no require any VAPs or NLMs running on the server.
XMETER uses Novells semaphores to monitor program usage. What you do is
create a BATCH file to load your software. You open a semaphore on the
way in and close it on the way out. The batch file must be programmed to
restrict access to the program. XMETER returns DOS errorlevel codes to
control batch files.
Example BATCH file for WordStar limited to 12 users:
@Echo Off
XMETER WORDSTAR 10 /O
if ErrorLevel 1 goto deny
cd\wordstar
ws
rem Close Semaphore when done.
XMETER WORDSTAR /C
goto e
:deny
cls
Echo Access Denied! All copies of WORDSTAR are in use.
rem Exit Here
:e
USING A METER LIST FILE:
XMETER can use a special text file to limit semaphore access. To use
this method, substitute the name of the list file for the MaxUsers
parameter as follows:
XMETER Lotus METER.LST /O
METER.LST
Lotus 10
Wordstar 15
dBase 9
This allows you to maintain the number of copies of each program in a
single list.
USAGE TRACKING:
Computer Tyme DOS ToolBox Users Manual Page 83
_______________________________________________________________
XMETER provides usage tracking by outputting a comma delimited ascii
line for each semaphore open and close. You must select the /L switch to
activate this feature. The line must be redirected to a usage log file
and you must write your own reporting program.
Example: XMETER TEST METER.LST /O/L >> USAGE.LOG
This command appends the following line to the file USAGE.LOG.
"MARC","254:41","2","LOTUS","1","O","Y","08-26-90","17:43:22"
The line contains 9 fields as follows:
1) User Name
2) Semaphore Name
3) Number of Semaphore users after execution
4) Command, O=Open C=Close
5) Success Status, Y=Success N=Failure
6) Date
7) Time
8) Internet Address of WorkStation
9) Logical Connection Number
TRICKS:
When XMETER creates semaphores, it adds the letters XM- to the front of
the semaphore name. So semaphore TEST is really XM-TEST. The idea here
is so that all XMETER semaphores can be indentified from other Netware
semaphores.
Whenever a workstation first uses XMETER it creates a semaphore named
XM-XMETER. This can be used to see how many users are using XMETER
software. This semaphore can be cleared by using the command:
XMETER XMETER/C
If a user turns off their computer while running an application, Novell
will release their semaphores after 15 minutes. All semaphores are also
released when the user logs out. If a user reboots within 15 minutes,
the semaphores are cleared upon login.
This software package is not the best program out there. It is designed
around being a simple 'just works' solution to software metering. It is
flexible and uses no memory on the workstation. I am looking for
feedback on this product.
For more sophisticated software metering use MarxMenu.
Computer Tyme DOS ToolBox Users Manual Page 84
_______________________________________________________________
LOGOFF.EXE LOGOFF.EXE LOGOFF.EXE
This program works like LOGOUT that comes with Novell except that it
modifies your PATH by removing drives you can no longer access. It also
will hunt up a new COMSPEC if necessary.
If you're running Pick Directory it will hunt up a new PD.PIC file.
If you don't want to see any messages when running LOGOFF in a batch
file you can redirect the output to nul as follows:
LOGOFF > NUL
After running LOGOFF you will need to run Attach to log back in.
This is a FREE Program. Distribute any way you like as long as you
include this DOC file with it. We hope you will try our other software
products.
LogOff also displays:
MARC logged out from server MARX connection 2.
Removing Path: Z:.
Removing Path: Y:.
Removing Path: X:.
Removing Path: W:.
Removing Path: P:.
Removing Path: U:.
Removing Path: S:.
PATH=C:\TURBO5;C:\;
Changing COMSPEC to: C:\COMMAND.COM
Setting Pick Directory File to: C:\PD.PIC
BESTNET.EXE BESTNET.EXE BESTNET.EXE
This program sets an environment variable NET to the best network shell
based on the DOS version and the presence of either EMS or XMS memory.
You can then load the net shell by putting %NET% in your batch file. If
both EMS and XMS are available, EMS is selected.
Usage: BESTNET (/I/X/L)
BESTNET > NUL ;This stops BestNet from writing to the screen.
/I Ignore XMS and EMS Shells.
/X Selects XMS over EMS where both exist.
/L Includes QEMM LoadHi command if LOADHI.COM is available.
Setting NET=EMSNET3.EXE
Computer Tyme DOS ToolBox Users Manual Page 85
_______________________________________________________________
This program helps take some of the pain out of booting up into Netware.
One of the problems on a network is that some people are running
different versions of DOS than others. Some have EMS memory and some
have XMS memory. Novell provides several shells for different computer
environments. BestNet helps choose the best net for your machine to
load. Thus making installation easier.
Here's how you use it. Your AUTOEXEC.BAT might look like this:
@Echo Off
IPX
SET COMSPEC=X:COMMAND.COM
BESTNET
%NET%
SET NET=
F:
LOGIN
The SET COMSPEC command has nothing to do with BestNet. It's a trick I
learned that eliminates DOS going back to the floppy for Command.com.
Setting the comspec before loading the net shell fixes this problem.
Another trick is to create a file called LOADNET.BAT as follows:
BESTNET
%NET%
SET NET=
F:
STARTUP
AUTOEXEC.BAT ----> LOADNET.BAT ----> STARTUP.BAT
The idea here is that each AUTOEXEC.BAT on the net ends with the command
LOADNET. This causes the AUTOEXEC to jump to LOADNET. LOADNET is exactly
the same for all workstations. You also put LOADNET in the LOGIN
directory. LOADNET loads the best shell and then branches to a batch
file called STARTUP which does your login.
The reason for three batch files is as follows. If you are booting from
a boot rom, you can have different AUTOEXEC for each user. These branch
to LOADNET which makes the transition from rom to the login directory.
As soon as the net shell loads the rom disappears and the LOADNET file
continues in the login directory.
The idea is that LOADNET never changes. You can change the AUTOEXEC and
the STARTUP bat files any way you want and still make a smooth
transition from your boot drive to the network.
Computer Tyme DOS ToolBox Users Manual Page 86
_______________________________________________________________
NS.EXE - NETSMART NS.EXE - NETSMART NS.EXE - NETSMART
This program helps make network dumb programs run better on a network.
It does this by allowing you to use filenames that contain references to
environment variables. These referrences are allowed in BATCH files but
not DOS programs. NetSmart solves this problem.
NetSmart also intercepts file access calls and translates compatibility
mode (or network dumb mode) to the more advanced sharing modes. The /L
option allows for liberal translation which could be somewhat dangerous
but is handy for very dumb programs.
By it's nature, this program isn't going to work with everything. If
it works, it works. If it doesn't, then don't use it.
Usage: NS (/L) <Command Line>
Example:
SET USERNAME=MARC
NS XCOPY F:\HOME\%USERNAME%\*.* A:
In this example, NS will translate the %USERNAME% into a file name that
DOS can handle.
When installing network dumb software, you can use environment variable
references for things like path names for configuration files. Thus, a
program that normally only gives you one filename option need not be
installed in every users directory.
NS is not exactly a TSR. It unloads itself each time it is run so you
have to use the NS command each time you use it. This way, NetSmart only
takes up memory with programs that need to use it.
Thank you for using our products.
Computer Tyme provides a Fast Update Service for all users for $125.00.
This service provides the user with automatic upgrades, priority tech
support access on the Computer Tyme BBS and product support for one
year. To order Priority Support Service, call 417-866-1222.
Computer Tyme DOS ToolBox Users Manual Page 87
_______________________________________________________________
OTHER COMPUTER TYME PRODUCTS OTHER COMPUTER TYME PRODUCTS OTHER COMPUTER TYME PRODUCTS
THE NETWORK SURVIVAL KIT
The Network Survival Kit contains over 40 utilities that make life on a
network easier. Includes a Zero k Menu Language, MarxMenu with over 450
commands used to create an "intellegent" user interface. MarxMenu offers
total screen control, pre-written customizable menus, accesses
environment variables, conditionals, math & string functions,
screen-blanking and password security on any level. A must for the
network supervisor. Also included in the Network Survival Kit is
software metering, TSR management, file management for varying user
levels, DOS shells, and much more.
MARXMENU
MarxMenu - The single user version has many of the same features as the
Network version mentioned above. MarxMenu is a must for consultants,
computer dealers, programmers, and anyone interested in developing a
custom user interface for clients, employees or for your own
personal use. MarxMenu lets you design menus to look any way you want!
Lots of pre-written menu templates included which provide menus easy
enough for the novice but powerful enough for the demanding jobs of
professionals. A powerful menu toolkit.
Other Computer Tyme Software:
======================================================
The Computer Tyme Dos ToolBox... Makes DOS easier for the novice,
more powerful for the professional.
DIRECTORY MASTER is a powerful hard disk managment utility. It
brings up your hard disk files and allows you to mark selected
files so you can copy them, delete them, or move them. It also
allows you to rename files, change dates, and change attributes.
You can also run programs or set up your function keys to run
programs on selected files.
DOLIST makes being at DOS easier. It gives you full line editing,
like a word processor, for your commands. It also stores commands
so that you can re-execute them. It remembers subdirectories and
allows you to go back to them by pressing the TAB key. It offers
programmable function keys, DOS extensions, multiple execution,
and many more features you have got to have.
PICK DIRECTORY allows you to move through the directory system by
displaying a graphic tree and letting you use your arrow keys to
move around. It also lets you create, delete, rename, and hide
directories.
TEDIT (from SemWare) is a powerful, easy to use full screen
editor.
MARXTSR is a set of memory and TSR management utilities that let
you load and unload TSRs (Terminate and stay resident programs)
from memory. Utilities to list menory allocation and turn TSR's
on and off.
And many more ... Also includes is D, a fancy directory listing
program; WHEREIS, for finding stuff on you hard disk, SORT, MOVE,
FIND, FREE, PIPEDIR, VERSION, and many more.
The Dos Toolbox sells for $59.95.
======================================================
We are also selling QEdit from Semware. QEdit is a professional
editor from Semware. TEdit is a mini version of QEdit. If you
like TEdit, You'll love QEdit.
1-800-548-5353 Order Line
1-417-866-1222 Voice Line
1-417-866-1665 BBS Data line * 1200/2400 * 8N1 * ANSI or VT100
MarxMenu comes with MarxEdit and MARXTSR manager and a few goodies out of
the DOS ToolBox. The Network Survival Kit is a network version of almost
every utility I've ever written. It's sold on a per fileserver basis.
_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| APPROVED VENDOR
==========================================
Make Check Computer Tyme Order Form
Payable To: 411 North Sherman Suite 300
Springfield Mo. 65802
(417) 866-1222 (800) 548-5353
Please send me Computer Tyme Software.
=============================================================
Name: ________________________________________________
Address: ________________________________________________
City/St/Zip: ________________________________________________
Phone: ________________________________________________
Computer: ________________________________________________
Got From: ________________________________________________
Comments: ________________________________________________
________________________________________________
Single User Version:
___ Enclosed is $59.95 for MarxMenu.
___ Enclosed is $35.00 for the DOS ToolBox. (Special Reg. $59.95)
___ Enclosed is $75.00 for MarxMenu, the Dos ToolBox and DM3.
Network Version (1 per file server):
___ Enclosed is $495 for Network Survival Kit.
___ Add $3.00 for Shipping and Handling.
___ I need 3 1/2 Inch Media.
Credit Card Number: _______________ Expiration Date: ________
Master Card __ Visa __ Discover __
* We do not take American Express *
=============================================================